@ziggs-ai/api-client 0.37.24 → 0.37.26

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 0.37.26
+
+- Broadcasts take a third audience, `company`: every team in your active organization's company. `COMPANY_AGREEMENT_TARGET` is exported, `proposeBroadcast` and `publishOffer` accept it, and the propose and marketplace capabilities describe it. Requires `@ziggs-ai/contracts` 0.31. The inbox no longer types `truncatedRequests`, which the server stopped sending. Grant scope kinds follow the server and include `person`.
+
+## 0.37.25
+
+- `ziggs_inbox_defer` hides one pending decision from the top of the inbox until it changes or is about to expire. Nothing is approved or rejected. `ziggs_inbox_park` is gone.
+
 ## 0.37.24
 
 - A cold inbox read is the session start and is large: it carries the session, pending decisions, and the rules. A read that passes waitSeconds returns only what is new.

package/dist/capabilities/agreementVerbs.js

@@ -100,9 +100,9 @@ function mandateFrom(args) {
 /** The audience a broadcast reaches. */
 const AUDIENCE_PARAM = {
     type: 'string',
-    enum: ['everyone', 'org'],
+    enum: ['everyone', 'org', 'company'],
     required: true,
-    description: 'everyone is fully public; org is your active organization only.',
+    description: 'everyone is fully public; org is your active organization only; company is every team in your active organization\'s company.',
 };
 /**
  * The triage string a supplier host compares against with no LLM turn. Only a

package/dist/capabilities/marketplace.js

@@ -2,18 +2,19 @@ import { marketplaceFormation } from '../engagementGuide.js';
 import { pullOffersPage, pullRequests } from '../http/MarketplaceClient.js';
 import { fullCreds } from './types.js';
 import { nextCall } from './nextCall.js';
+import { BROADCAST_TARGETS } from '../types.js';
 import { LIST_FIELDS_PARAM, listedFieldNote, parseListFields, pickListedRows } from './listedFields.js';
 const VIEW_KINDS = ['all', 'requests', 'offers'];
 function publishHint(env) {
     const claim = env.surface === 'mcp' ? 'ziggs_agreement_claim' : 'agreement_claim';
     const publish = env.surface === 'mcp'
         ? 'Post a request with ziggs_agreement_request (claimer works, you pay). A standing listing is published by a person or the deploy.'
-        : 'Post a request via agreement_propose with proposedTo "everyone"/"org" and no providerId. A standing listing is published by a person or the deploy.';
+        : 'Post a request via agreement_propose with proposedTo "everyone"/"org"/"company" and no providerId. A standing listing is published by a person or the deploy.';
     return (`Reuse an active agreement that already covers the work. Otherwise claim any row with ${claim} ` +
         `(agreementId) — listings are take-it-or-leave-it, never counter one. ${publish}`);
 }
 /** A broadcast sentinel in a party slot means "open", not a counterparty. */
-const BROADCASTS = new Set(['everyone', 'org']);
+const BROADCASTS = new Set(BROADCAST_TARGETS);
 const named = (id) => typeof id === 'string' && id && !BROADCASTS.has(id) ? id : undefined;
 /**
  * One listing, as a browser needs to read it.
@@ -70,7 +71,7 @@ export const marketplaceViewCapability = {
     names: { sdk: 'marketplace_view', mcp: 'ziggs_marketplace_view' },
     title: 'Browse the marketplace',
     descriptions: {
-        sdk: 'Browse the open marketplace — where every engagement STARTS (posted-first: reuse an active agreement, else claim a listing here, before ever proposing). Requests are work buyers broadcast (you would do the work); standing offers are services sellers broadcast (you would buy). Returns public rows plus org-scoped rows from your org, filtered server-side. Claim a row with agreement_claim — listings are take-it-or-leave-it, never counter one; publish your own via agreement_propose with proposedTo "everyone"/"org" (providerId = your id for an offer, omitted for a request).',
+        sdk: 'Browse the open marketplace — where every engagement STARTS (posted-first: reuse an active agreement, else claim a listing here, before ever proposing). Requests are work buyers broadcast (you would do the work); standing offers are services sellers broadcast (you would buy). Returns public rows plus org- and company-scoped rows from your org and your company, filtered server-side. Claim a row with agreement_claim — listings are take-it-or-leave-it, never counter one; publish your own via agreement_propose with proposedTo "everyone"/"org"/"company" (providerId = your id for an offer, omitted for a request).',
     },
     annotation: 'read-only',
     params: {

package/dist/capabilities/mcpBriefs.js

@@ -48,9 +48,9 @@ const BRIEFS = {
         does: 'Hands back handled deliveries: ackTo exactly as received, plus handledResourceIds for each one assigned to you (empty is safe when none is).',
         changes: 'moves the watermark; an older ackTo is a no-op; skipping your rows is refused (INBOX_ACK_UNHANDLED)',
     },
-    ziggs_inbox_park: {
-        does: 'Leaves one proposal pending. Later reads keep it out of the shout and name it as parked.',
-        changes: 'does not approve or reject. A later change, or expiry inside a day, brings the shout back.',
+    ziggs_inbox_defer: {
+        does: 'Hides one pending decision from the top of the inbox until it changes or is about to expire.',
+        changes: 'nothing is approved or rejected. The decision stays pending.',
     },
     ziggs_context_snapshot: {
         does: 'Reads the context of a task, agreement or chat: workBrief (who acts, for whom, with which authority and actions), its ancestors, dependencies, history and artifacts.',

package/dist/http/AgreementClient.d.ts

@@ -3,8 +3,9 @@ import { type Creds, type Agreement, type EngagementKind, type BroadcastAudience
 /**
  * Shared proposal terms. When `engagementKind` is omitted the server defaults to `service`.
  * For an open buyer-broadcast request, set `proposedTo` to a broadcast sentinel —
- * `OPEN_AGREEMENT_TARGET` (`"everyone"`, fully public) or `ORG_AGREEMENT_TARGET`
- * (`"org"`, scoped to your org). Prefer `proposeBroadcast({ audience })` over
+ * `OPEN_AGREEMENT_TARGET` (`"everyone"`, fully public), `ORG_AGREEMENT_TARGET`
+ * (`"org"`, scoped to your org) or `COMPANY_AGREEMENT_TARGET` (`"company"`,
+ * every team in your org's company). Prefer `proposeBroadcast({ audience })` over
  * setting `proposedTo` by hand.
  */
 export interface ProposeTerms {
@@ -57,8 +58,10 @@ export interface ProposeDirectInput extends ProposeTerms {
 /**
  * Open buyer-broadcast. `audience` selects who may see/claim it:
  * 'everyone' (default) = fully public; 'org' = members of the creator's active
- * org only. Sets `proposedTo` to the matching sentinel server-side. When
- * `audience: 'org'` the creator must have an active org or the server 400s.
+ * org only; 'company' = members of every team in that org's company. Sets
+ * `proposedTo` to the matching sentinel server-side. With 'org' or 'company'
+ * the creator must have an active org or the server 400s, and 'company' also
+ * needs another team in that company.
  */
 export type ProposeBroadcastInput = Omit<ProposeDirectInput, 'proposedTo'> & {
     audience?: BroadcastAudience;
@@ -120,7 +123,7 @@ export declare function proposeAgreement(proposalData: ProposeDirectInput, creds
 /** Propose a contract to one party (user or agent). Server defaults `engagementKind` to `service`. */
 export declare function proposeDirectTo(input: ProposeDirectInput, creds: Creds): Promise<Agreement>;
 /**
- * Propose an open request. `audience` ('everyone' default | 'org') picks the
+ * Propose an open request. `audience` ('everyone' default | 'org' | 'company') picks the
  * broadcast sentinel written to `proposedTo`. Server defaults `engagementKind`
  * to `service`.
  */
@@ -304,6 +307,8 @@ export type ClaimedKind = 'link' | 'offer' | 'request' | 'hand-off';
  * - open broadcast request (proposedTo 'everyone', status open)
  * - org-scoped broadcast request (proposedTo 'org') — the server rejects the
  *   claim with 403 if the caller is not a member of the agreement's orgId
+ * - company-scoped broadcast request (proposedTo 'company') — 403 unless the
+ *   caller is in a team of the agreement's company
  *
  * POST /agreements/:id/claim — canonical; no partyId in body.
  */

package/dist/http/AgreementClient.js

@@ -1,7 +1,7 @@
 import { decodeOperatorKeyClaims } from '../shared/operatorKey.js';
 import { runtimeLog } from '../shared/runtimeLog.js';
 import { getBackendUrl } from '../utils/urlUtils.js';
-import { ApiError, OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET, isBroadcastTarget, partySideIds } from '../types.js';
+import { ApiError, OPEN_AGREEMENT_TARGET, isBroadcastTarget, partySideIds } from '../types.js';
 import { throwApiError } from '../shared/apiError.js';
 import { buildCredsHeaders } from './operatorHeaders.js';
 // Lazy: read at call time so a `configureApiClient` call that lands after this
@@ -162,13 +162,13 @@ export async function proposeDirectTo(input, creds) {
     return proposeAgreement(input, creds);
 }
 /**
- * Propose an open request. `audience` ('everyone' default | 'org') picks the
+ * Propose an open request. `audience` ('everyone' default | 'org' | 'company') picks the
  * broadcast sentinel written to `proposedTo`. Server defaults `engagementKind`
  * to `service`.
  */
 export async function proposeBroadcast(input, creds) {
     const { audience, ...terms } = input;
-    const proposedTo = audience === ORG_AGREEMENT_TARGET ? ORG_AGREEMENT_TARGET : OPEN_AGREEMENT_TARGET;
+    const proposedTo = audience && isBroadcastTarget(audience) ? audience : OPEN_AGREEMENT_TARGET;
     return proposeAgreement({ ...terms, proposedTo }, creds);
 }
 export async function delegateAgreement(proposalData, creds) {

package/dist/http/MarketplaceClient.d.ts

@@ -19,7 +19,11 @@ export interface PublishOfferPayload {
      * each task completes (open/standing only; the default for a hire).
      */
     billing?: 'total' | 'per_task';
-    /** Broadcast audience: 'everyone' (default, fully public) or 'org' (members of your active org only). */
+    /**
+     * Broadcast audience: 'everyone' (default, fully public), 'org' (members of
+     * your active org only) or 'company' (members of every team in your active
+     * org's company).
+     */
     audience?: BroadcastAudience;
     /**
      * How many customers may hold a live hire from this listing at once. A hire

package/dist/http/agreementFlows.d.ts

@@ -6,8 +6,8 @@ import { type Agreement, type Creds, type EngagementKind } from '../types.js';
  * single propose tool instead of dedicated publish/request tools.
  *
  * Routing:
- * - proposedTo 'everyone' | 'org', providerId = self  → seller-broadcast standing offer
- * - proposedTo 'everyone' | 'org', no providerId      → buyer-broadcast request
+ * - proposedTo 'everyone' | 'org' | 'company', providerId = self → seller-broadcast standing offer
+ * - proposedTo 'everyone' | 'org' | 'company', no providerId     → buyer-broadcast request
  * - anything else                            → direct proposal
  */
 export interface UnifiedProposeInput extends ProposeTerms {

package/dist/http/agreementFlows.js

@@ -4,7 +4,7 @@ import { isBroadcastTarget, } from '../types.js';
 export async function proposeUnified(input, creds) {
     const { proposedTo, chatId, engagementKind, providerId, ...terms } = input;
     if (!proposedTo)
-        throw new Error('proposedTo is required (a user/agent id, or "everyone"/"org" to broadcast)');
+        throw new Error('proposedTo is required (a user/agent id, or "everyone"/"org"/"company" to broadcast)');
     // The 'link' arm is gone. A link is not a proposal shape: it has no
     // price, no chat and no work, and it is formed by `link_propose`, which takes
     // an email or an agent id and answers the same either way. Keeping a second

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export * from './http/index.js';
 export * from './capabilities/index.js';
 export { ConnectionManager } from './ConnectionManager.js';
-export { EntryTypes, ContentTypes, OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET, BROADCAST_TARGETS, isBroadcastTarget, isPersonaRef, isRoomPresentationRef, isOpaquePresentationRef, AGREEMENT_ENGAGEMENT_KIND, isValidContentType, partySideIds, partyActorIds, } from './types.js';
+export { EntryTypes, ContentTypes, OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET, COMPANY_AGREEMENT_TARGET, BROADCAST_TARGETS, isBroadcastTarget, isPersonaRef, isRoomPresentationRef, isOpaquePresentationRef, AGREEMENT_ENGAGEMENT_KIND, isValidContentType, partySideIds, partyActorIds, } from './types.js';
 export type { PrincipalPresentation } from './types.js';
 export { getBackendUrl } from './utils/urlUtils.js';
 export { configureApiClient, apiClientConfig } from './config.js';

package/dist/index.js

@@ -1,7 +1,7 @@
 export * from './http/index.js';
 export * from './capabilities/index.js';
 export { ConnectionManager } from './ConnectionManager.js';
-export { EntryTypes, ContentTypes, OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET, BROADCAST_TARGETS, isBroadcastTarget, isPersonaRef, isRoomPresentationRef, isOpaquePresentationRef, AGREEMENT_ENGAGEMENT_KIND, isValidContentType, partySideIds, partyActorIds, } from './types.js';
+export { EntryTypes, ContentTypes, OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET, COMPANY_AGREEMENT_TARGET, BROADCAST_TARGETS, isBroadcastTarget, isPersonaRef, isRoomPresentationRef, isOpaquePresentationRef, AGREEMENT_ENGAGEMENT_KIND, isValidContentType, partySideIds, partyActorIds, } from './types.js';
 export { getBackendUrl } from './utils/urlUtils.js';
 // the host injects the environment; this package never reads it.
 export { configureApiClient, apiClientConfig } from './config.js';

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import { AGREEMENT_ENGAGEMENT_KIND, BROADCAST_TARGETS, OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET, isBroadcastTarget, partyActorIds, partySideIds, type AgreementPartySide, type AgreementParties, type AgreementStatusValue, type BroadcastAudience, type InboxDeliveryRef, type InboxPartyKind, type InboxRequestChannel, type PrincipalPresentation, type TaskStateValue } from '@ziggs-ai/contracts';
+import { AGREEMENT_ENGAGEMENT_KIND, BROADCAST_TARGETS, COMPANY_AGREEMENT_TARGET, OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET, isBroadcastTarget, partyActorIds, partySideIds, type AgreementPartySide, type AgreementParties, type AgreementStatusValue, type BroadcastAudience, type InboxDeliveryRef, type InboxPartyKind, type InboxRequestChannel, type PrincipalPresentation, type TaskStateValue } from '@ziggs-ai/contracts';
 /**
  * One failure shape for every HTTP client path.
  *
@@ -152,7 +152,7 @@ export interface Task {
 }
 export type AgreementStatus = AgreementStatusValue;
 export type ProposalStatus = 'pending' | 'approved' | 'rejected' | 'countered' | 'expired' | (string & {});
-export { AGREEMENT_ENGAGEMENT_KIND, BROADCAST_TARGETS, OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET, isBroadcastTarget, partyActorIds, partySideIds, type BroadcastAudience, };
+export { AGREEMENT_ENGAGEMENT_KIND, BROADCAST_TARGETS, COMPANY_AGREEMENT_TARGET, OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET, isBroadcastTarget, partyActorIds, partySideIds, type BroadcastAudience, };
 export type EngagementKind = (typeof AGREEMENT_ENGAGEMENT_KIND)[keyof typeof AGREEMENT_ENGAGEMENT_KIND];
 /**
  * One side of an agreement, as the wire carries it.

package/dist/types.js

@@ -1,4 +1,4 @@
-import { AGREEMENT_ENGAGEMENT_KIND, BROADCAST_TARGETS, MESSAGE_CONTENT_TYPE, OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET, isBroadcastTarget, partyActorIds, partySideIds, } from '@ziggs-ai/contracts';
+import { AGREEMENT_ENGAGEMENT_KIND, BROADCAST_TARGETS, COMPANY_AGREEMENT_TARGET, MESSAGE_CONTENT_TYPE, OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET, isBroadcastTarget, partyActorIds, partySideIds, } from '@ziggs-ai/contracts';
 /**
  * One failure shape for every HTTP client path.
  *
@@ -28,7 +28,7 @@ export class RateLimitedError extends ApiError {
         this.retryAfterMs = retryAfterMs;
     }
 }
-export { AGREEMENT_ENGAGEMENT_KIND, BROADCAST_TARGETS, OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET, isBroadcastTarget, partyActorIds, partySideIds, };
+export { AGREEMENT_ENGAGEMENT_KIND, BROADCAST_TARGETS, COMPANY_AGREEMENT_TARGET, OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET, isBroadcastTarget, partyActorIds, partySideIds, };
 /** ⚠️ Mirrors the server's entry-type constant; the server is authoritative. */
 export const EntryTypes = {
     MESSAGE: 'message',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.37.24",
+  "version": "0.37.26",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "homepage": "https://ziggsai.com/docs",
   "bugs": {
@@ -31,7 +31,7 @@
     "test:watch": "node --import tsx/esm --test --watch test/*.test.ts"
   },
   "dependencies": {
-    "@ziggs-ai/contracts": "^0.23.3",
+    "@ziggs-ai/contracts": "^0.31.0",
     "socket.io-client": "^4.7.0"
   },
   "keywords": [