Repository navigation
Releases
coss-cli 0.8.0
Minor Changes
- 1f308eb: Authenticate with OIDC instead of an API key: an environment's OIDC credential trusts ID tokens from GitHub Actions, Vercel, GitLab, CircleCI or any public issuer, and
new Coss({ oidc: { credentialId } })(orCOSS_OIDC_CREDENTIAL_ID) exchanges the job's or function's token for a short-lived access token and renews it on its own.coss.oidc.exchangeToken()does the exchange by hand. The CLI and the MCP server useCOSS_OIDC_CREDENTIAL_IDwhen noCOSS_API_KEYis set. - The MCP server's
create_scheduling_sessioncan make a team lead's page withmanager_hosts, andcoss openknows the out of office, holidays and reassignments pages. - 867d240: Reassign scheduling bookings:
coss.scheduling.bookings.reassigngives any kind of booking to another host, keeping its id and time, andreassignCandidatessays who could take it and why not. Adds ascheduling.booking.reassignedwebhook withprevious_host_ids,reassignment_enabledon event types andname_host_in_attendee_emailsin settings. The MCP server gets reassign and out of office tools, and the CLIcoss scheduling reassign,candidatesandooo. - 7970389: Move many scheduling bookings at once:
coss.scheduling.reassignmentspreviews who each would go to, runs it in the background with an outcome per booking, and can cancel and undo. Out of office entries takeexisting_bookings: "reassign"to start one. Adds ascheduling.reassignment.completedwebhook. The MCP server gets preview, create, get, cancel and undo tools, and the CLIcoss scheduling reassign-many,reassignmentsandreassignment.
Patch Changes
- e7a9087: Scheduling's own OAuth apps:
coss.scheduling.oauthAppsconnects hosts' calendars through your own Google, Microsoft or Zoom app, so the consent screen shows your brand. Calendar connections gainoauth_app, settings gainprivacy_url, and there arescheduling.oauth_app.failingand.restoredwebhooks.coss open scheduling-oauth-appsopens its dashboard page. - Updated dependencies [1f308eb]
- Updated dependencies [a3bb0d7]
- Updated dependencies [4ddea4e]
- Updated dependencies [fab9a95]
- Updated dependencies [e7a9087]
- Updated dependencies [152e25e]
- Updated dependencies [867d240]
- Updated dependencies [7970389]
- coss@0.13.0
coss-cli 0.7.0
Minor Changes
- 2012767: Setup and diagnosis know every product.
fetchSetupReport(coss, { product }), the MCP server'sget_setupandcoss init --productsay what a product still needs or how to try it in a sandbox, and reportproductsandproducts_in_usenext to the fields they had.coss/diagnoseadds SMS, Verify, Sign, Forms, Hooks and Scheduling, as MCP tools (diagnose_verification,diagnose_sign_request,diagnose_form_submission,diagnose_hook_delivery,diagnose_scheduling_slots) and CLI commands (coss sms diagnose,coss verify diagnose,coss sign diagnose,coss forms diagnose,coss hooks diagnose,coss scheduling diagnose). The MCP server also getslist_email_templates, log drain and sub-account tools,api_get(a read-only fallback for any/v1/path), output schemas onget_setupand the diagnose tools, and its first prompts and resources. - a7ff535: Verify's settings have an API:
coss.verify.settings.get()and.update(). The MCP server gets tools for marketing (contacts, audiences, segments, topics, broadcasts), Verify and Sign, and more for Forms, Scheduling, Hooks and Risk, plusCOSS_MCP_TOOLSETSto offer fewer of them. The CLI getscoss verify,coss contacts,coss broadcastsandcoss sign, and more ofcoss sms,coss formsandcoss scheduling. - 1d11cf9: The CLI manages what it could only read. New:
coss suppressions,coss subaccounts,coss log-drains,coss audiences,coss segments,coss topics,coss marketing settings,coss risk rules,coss risk check,coss risk classify,coss risk settings,coss sign settingsandcoss scheduling schedules;coss emails cancelandreschedule,coss sms cancel,coss sms suppressions check,coss contacts update,importandexport,coss broadcasts update,remove,pauseandresume,coss forms updateandremove,coss sign templates create, andcoss scheduling hosts create,updateandremove,event-types createandupdate,book,reschedule,approveanddecline.coss openknows every page of the dashboard, and unknown commands point atcoss api. - 17ac7bc: Scheduling bookings have a readable history:
coss.scheduling.bookings.events(id), the MCP server'slist_scheduling_booking_eventsandcoss scheduling booking-events. A cancelled booking says who cancelled it incancelled_by, andbookings.canceltakes an optionalreason, which only retrieving that booking returns.bookings.cancel's second argument is now its parameters, and request options moved to the third, as onseries.cancel. - 4168d9e: Scheduling slots explain themselves.
coss.scheduling.slots.explain(eventType, { start }), the MCP server'sexplain_scheduling_slotandcoss scheduling slots explainsay whether one start can be booked right now and, host by host, why not. Slots also carryseats_leftfor group event types. - 6d31dd3: Scheduling reminders:
remindersoncoss.scheduling.settingsand event types say what goes out around a booking, timed from its start, end or any change to it, to attendees, hosts, fixed addresses or a webhook, in your own words if you like.coss.scheduling.bookings.notifications()lists what was queued and why anything wasn't sent. New webhooks:scheduling.booking.started,scheduling.booking.endedandscheduling.booking.reminder. Hosts take aphone, event types takenotifications, and settings takeemail_reply_to. The MCP server getsget_scheduling_reminders,save_scheduling_reminders,list_scheduling_booking_notificationsandmark_scheduling_no_show, and the CLIcoss scheduling reminders,notificationsandno-show.
Patch Changes
- 05dd81b: Scheduling's calendar delegations:
coss.scheduling.calendarDelegationslets an admin authorize a Google Workspace or Microsoft 365 domain once, so every host on it gets their calendar with no consent screen. Hosts gaincalendar_account, calendar connections gaindelegation, and there arescheduling.calendar_delegation.failingand.restoredwebhooks.coss open scheduling-calendar-delegationopens its dashboard page. - Updated dependencies [2012767]
- Updated dependencies [a7ff535]
- Updated dependencies [05dd81b]
- Updated dependencies [9e79d10]
- Updated dependencies [8dacd0f]
- Updated dependencies [411767c]
- Updated dependencies [fb681ad]
- Updated dependencies [97e84b2]
- Updated dependencies [cbed6ab]
- Updated dependencies [56a7443]
- Updated dependencies [17ac7bc]
- Updated dependencies [346c63f]
- Updated dependencies [4168d9e]
- Updated dependencies [f099789]
- Updated dependencies [895ef91]
- Updated dependencies [cee7e38]
- Updated dependencies [11286f6]
- Updated dependencies [6d31dd3]
- Updated dependencies [0101bab]
- Updated dependencies [ddf6142]
- Updated dependencies [7452381]
- coss@0.12.0
coss-cli 0.6.0
Minor Changes
-
7afbbef: Forms: the MCP server's
list_forms,list_form_submissionsandget_form_submissiontools (submitted
values labelled untrusted), and the CLI'scoss forms listandcoss forms submissions <form>
(--status,--limit,--json). -
a2ed56a: Adds
coss.scheduling: hosts, schedules, event types, slots, availability search, bookings, holds, recurring
series, calendars, sessions and settings.coss/schedulingembeds the hosted pages (mountBooker,
mountHostPortal).coss-mcpgets tools to list hosts, slots and bookings and to cancel a booking;coss-cligets
coss scheduling hostsandcoss scheduling bookings.
Patch Changes
- b4cb758:
coss listenforwards an event'sdata.traceparentas atraceparentheader, as coss.com's own
webhook delivery does. - 014f709:
coss openfollows the dashboard's product-first URLs (/<org>/<project>/<env>/email/domains,
/<org>/settings/members) and opens more pages:products,email,sms,verify,sign,
forms,inboxes,developers,subaccountsandspend. - Updated dependencies [a951582]
- Updated dependencies [545d704]
- Updated dependencies [09ccfba]
- Updated dependencies [9f31e28]
- Updated dependencies [9d65e49]
- Updated dependencies [95707e1]
- Updated dependencies [a2ed56a]
- Updated dependencies [b4cb758]
- coss@0.11.0
coss-cli 0.5.0
Minor Changes
- daf97ff: Inboxes: the MCP server gains
create_inbox,list_inboxes,list_inbox_threads,get_inbox_thread,send_inbox_messageandreply_to_inbox_message; the CLI gainscoss inboxes list|create|threads|thread|reply.
Patch Changes
- Updated dependencies [0464e77]
- Updated dependencies [e97dd14]
- Updated dependencies [80a9c6f]
- Updated dependencies [62cdc89]
- Updated dependencies [fbdc39f]
- Updated dependencies [9d4c942]
- Updated dependencies [f9f26a4]
- Updated dependencies [d55a308]
- Updated dependencies [7e77a8e]
- Updated dependencies [0718160]
- Updated dependencies [c0e5c69]
- Updated dependencies [a85e735]
- Updated dependencies [a4e2b6a]
- coss@0.10.0
coss-cli 0.4.0
Minor Changes
-
57397ff: Setup status for agents, error hints, and one project key.
describeSetupreports a from address that will succeed and one next step. API errors can includehint(a fix, often with a docs URL), and the SDK copies it ontoCossError.coss initwrites agent notes by default, points at the project's mail library or framework driver, and prints that setup.coss listenwritesCOSS_WEBHOOK_SECRETinto the project env file.coss-mcploads a development key from that file and adds setup, risk, Hooks and template tools. -
2b6c98e: Publish a template and register a webhook endpoint from the tools an agent already uses.
publish_email_templatepublishes the draft revision it just read.create_webhook_endpointandcoss webhooks addcreate an endpoint once and write its signing secret to the project env file asCOSS_WEBHOOK_SECRET. A URL that already has an endpoint is left as it is.coss initsnippets send to the mailbox simulator from the address setup reports.
Patch Changes
- Updated dependencies [57397ff]
- Updated dependencies [2b6c98e]
- coss@0.9.0
coss-cli 0.3.0
Minor Changes
- 9978333:
coss init --agents: adds a short section on coss.com for coding agents (where the docs are, what the development key does, how to test) to the project'sAGENTS.md, or itsCLAUDE.mdwhen it has noAGENTS.md. Running it again updates the section.--jsonreports the file asagents_file. - 57cc163: Scoped API keys:
coss.environment.get()now returns the key'sapi_key.access(fullorrestricted) andapi_key.permissions(resource:actionstrings, e.g.email:send). The MCP server'sget_account_statusreports them and its permission errors say the key is restricted;coss whoamiprints the key's access. - fb711e1:
coss sms send: a test text message (--to, or--simulate delivered|invalid|filtered|opted-out|replyfor the SMS simulator;--waitfollows it to its outcome and shows the simulator's reply).
Patch Changes
- Updated dependencies [2f2c982]
- Updated dependencies [001c8ed]
- Updated dependencies [57cc163]
- Updated dependencies [ecaa8cc]
- Updated dependencies [9d872c0]
- Updated dependencies [ce6f1e6]
- Updated dependencies [2f2c982]
- coss@0.8.0
coss-cli 0.2.0
Minor Changes
- e13f0e4:
coss.email.templates.render(template, { version, locale, variables })renders a template's draft (or a published version) as a send would, without sending (POST /v1/email_templates/{id}/render). The CLI getscoss domains list|add|get|verify(DNS records as a table or zone-file lines with--format bind;verify --waitfollows the domain until it's verified) and templates as code:coss templates list|pull|push|preview(a folder per template,push --watchand--publish,preview --var … --open). - 2857473:
coss/diagnoseexplains an email's delivery:diagnose(coss, id)reads the email, its events and its account context, anddiagnoseEmailis the pure part (moved fromcoss-mcp, which now uses it and still re-exports it). The CLI getscoss emails list,coss emails get,coss emails eventsandcoss emails diagnose, andcoss inbox(the inbound domain, then received emails as they arrive) withcoss inbox get. - e2ddd7a:
coss hooks …: create Hooks applications, event types and endpoints (endpoints addprints the signing secret), send messages (--data,-Ffields, or the event type's example), follow deliveries and their attempts, retry one, and open an application's portal.coss risk …: assess an event and see the decision, score and reasons (sandbox fixtures produce each decision), list assessments and the review queue, send feedback, and manage the allow and block lists. Help and errors for groups inside groups (coss hooks apps) now name their own commands. - 3a02992:
coss initsets a project up: it installscosswith the project's package manager and writes a new development key, approved in the dashboard and named after the project, to.env.local(Next.js) or.env.coss profiles listandcoss use <profile>show and switch the saved profiles, andcoss open [page]opens the environment's dashboard page. A daily update notice says when a newer coss-cli exists (COSS_NO_UPDATE_CHECK=1turns it off), and completion offers saved profile names. - 78b99d3: Test webhook events:
coss.webhookEvents.test({ type, data })(POST /v1/webhook_events/test) sends a sample event of a type to the environment's subscribed endpoints and open listeners, exactly like a real one (sandbox keys; every type but the live-onlydomain.*,account.*andbilling.*). The SDK also exportsWEBHOOK_EVENT_TYPES,TEST_WEBHOOK_EVENT_TYPESandisLiveOnlyEventType. The CLI getscoss trigger <event-type>(with--dataand-F, socoss listen+coss triggerexercises a local handler), andcoss webhooks list,coss webhooks deliveries <endpoint>andcoss webhooks retry <endpoint> <delivery>. - 8fea903:
coss.request(method, path, options)calls any endpoint by its path (for one the SDK has no method for yet), with the client's key, version, timeout and retries; POST, PUT and PATCH are retried only withretry: true. The CLI's newcoss api <path>uses it:-f/-Ffields,--inputbodies (or stdin),--paginateand--raw. Alsocoss completion bash|zsh|fish, and every command's--helpis now generated from its flags.
Patch Changes
- Updated dependencies [e13f0e4]
- Updated dependencies [2857473]
- Updated dependencies [78b99d3]
- Updated dependencies [8fea903]
- coss@0.7.0