@ziggs-ai/api-client 0.37.12 → 0.37.14

package/dist/capabilities/index.d.ts

@@ -4,6 +4,7 @@ export { type McpBrief, type McpDoor, hasMcpBrief, mcpBriefNames, mcpDescription
 export { nextCall, nextCallsFromUntrustedContent, isStaleAdvertisedAction, peerPrincipalId, isPersonaFace, workContextFromEnv, type NextCall, type NextCallOutcome, type NextCallEffects, type NextCallHold, type NextCallOptions, type WorkContext, } from './nextCall.js';
 export { AGREEMENT_VERB_CAPABILITIES, LISTING_DOOR_CAPABILITIES, agreementBuyCapability, agreementBidCapability, agreementBrokerCapability, agreementRequestCapability, agreementHandoffCapability, agreementSubcontractCapability, } from './agreementVerbs.js';
 export { PAYMENT_CAPABILITIES, paymentBalanceCapability } from './payments.js';
+export { PARTY_CAPABILITIES, partyNoteCapability } from './parties.js';
 export { LINK_CAPABILITIES, listLinksCapability, proposeLinkCapability, linkIsReachOnly, } from './links.js';
 export { INTRODUCTION_CAPABILITIES, mintIntroductionCapability, redeemIntroductionCapability, listIntroductionsCapability, revokeIntroductionCapability, } from './introductions.js';
 export { AGREEMENT_CAPABILITIES, agreementClaimCapability, presentClaimResult, } from './agreements.js';

package/dist/capabilities/index.js

@@ -4,6 +4,7 @@ export { hasMcpBrief, mcpBriefNames, mcpDescription, } from './mcpBriefs.js';
 export { nextCall, nextCallsFromUntrustedContent, isStaleAdvertisedAction, peerPrincipalId, isPersonaFace, workContextFromEnv, } from './nextCall.js';
 export { AGREEMENT_VERB_CAPABILITIES, LISTING_DOOR_CAPABILITIES, agreementBuyCapability, agreementBidCapability, agreementBrokerCapability, agreementRequestCapability, agreementHandoffCapability, agreementSubcontractCapability, } from './agreementVerbs.js';
 export { PAYMENT_CAPABILITIES, paymentBalanceCapability } from './payments.js';
+export { PARTY_CAPABILITIES, partyNoteCapability } from './parties.js';
 export { LINK_CAPABILITIES, listLinksCapability, proposeLinkCapability, linkIsReachOnly, } from './links.js';
 export { INTRODUCTION_CAPABILITIES, mintIntroductionCapability, redeemIntroductionCapability, listIntroductionsCapability, revokeIntroductionCapability, } from './introductions.js';
 export { AGREEMENT_CAPABILITIES, agreementClaimCapability, presentClaimResult, } from './agreements.js';

package/dist/capabilities/mcpBriefs.js

@@ -237,6 +237,10 @@ const BRIEFS = {
         does: 'Takes back an introduction you minted that nobody has redeemed.',
         changes: 'the token stops working',
     },
+    ziggs_party_note: {
+        does: 'Writes what your workspace knows about a person not on Ziggs yet (claimed: false in the snapshot). Shown to your workspace in every room they are in.',
+        changes: 'replaces the notes; empty clears them',
+    },
     // Connections and points
     ziggs_connection_list: {
         does: 'Lists third-party connections (GitHub, Jira, MCP servers) you hold grants on, with grant health; never credentials. They are listed, not callable over this connection.',

package/dist/capabilities/parties.d.ts

@@ -0,0 +1,10 @@
+import { type CapabilityDefinition } from './types.js';
+/**
+ * What your workspace knows about a person who is not on Ziggs yet.
+ *
+ * The room snapshot names them in `users` with `claimed: false`, and carries
+ * these notes for your workspace's readers, so the next session that wakes
+ * knows who they are without asking again.
+ */
+export declare const partyNoteCapability: CapabilityDefinition;
+export declare const PARTY_CAPABILITIES: CapabilityDefinition[];

package/dist/capabilities/parties.js

@@ -0,0 +1,43 @@
+import { PartiesClient } from '../http/PartiesClient.js';
+import { fullCreds } from './types.js';
+/**
+ * What your workspace knows about a person who is not on Ziggs yet.
+ *
+ * The room snapshot names them in `users` with `claimed: false`, and carries
+ * these notes for your workspace's readers, so the next session that wakes
+ * knows who they are without asking again.
+ */
+export const partyNoteCapability = {
+    key: 'party_note',
+    names: { sdk: 'party_note', mcp: 'ziggs_party_note' },
+    title: 'Note who a person not on Ziggs yet is',
+    descriptions: {
+        sdk: 'Replace what your workspace knows about a person who is not on Ziggs yet: who they are, how you met, what they asked for (PUT /parties/{partyId}/notes). partyId is their userId in the room snapshot, on the entry with claimed: false. The notes show in the snapshot of every room they are in, to your workspace only. An empty string clears them; at most 2000 characters. Write what you learned, not what they said verbatim.',
+    },
+    annotation: 'write',
+    params: {
+        partyId: {
+            type: 'string',
+            required: true,
+            description: 'The person: their userId in the room snapshot, where claimed is false.',
+        },
+        notes: {
+            type: 'string',
+            required: true,
+            description: 'The whole note, replacing the previous one. Empty clears it. At most 2000 characters.',
+        },
+    },
+    needsAgentId: true,
+    handler: async (args, env) => {
+        const creds = fullCreds(env);
+        const client = new PartiesClient(creds.operatorKey, creds.agentId);
+        const saved = await client.setNotes(args['partyId'], args['notes']);
+        return {
+            party: saved,
+            message: saved.notes
+                ? 'Saved. It shows in the snapshot of every room they are in, to your workspace only.'
+                : 'Cleared.',
+        };
+    },
+};
+export const PARTY_CAPABILITIES = [partyNoteCapability];

package/dist/capabilities/toolLane.js

@@ -9,6 +9,7 @@ import { GRANTS_CAPABILITIES } from './grants.js';
 import { INTRODUCTION_CAPABILITIES } from './introductions.js';
 import { LINK_CAPABILITIES } from './links.js';
 import { MARKETPLACE_CAPABILITIES } from './marketplace.js';
+import { PARTY_CAPABILITIES } from './parties.js';
 import { PAYMENT_CAPABILITIES } from './payments.js';
 import { TASK_CAPABILITIES } from './tasks.js';
 const CAPABILITIES = [
@@ -25,6 +26,7 @@ const CAPABILITIES = [
     ...INTRODUCTION_CAPABILITIES,
     ...LINK_CAPABILITIES,
     ...MARKETPLACE_CAPABILITIES,
+    ...PARTY_CAPABILITIES,
     ...PAYMENT_CAPABILITIES,
     ...TASK_CAPABILITIES,
 ];

package/dist/http/PartiesClient.d.ts

@@ -0,0 +1,18 @@
+/** What a workspace keeps about a person who is not on Ziggs yet. */
+export interface PartyNotesView {
+    partyId: string;
+    notes: string | null;
+}
+/**
+ * A person who is not on Ziggs yet, as your workspace keeps them: someone it
+ * reaches by email or Slack. Only the workspace that vouches for them writes
+ * or reads what it knows about them.
+ */
+export declare class PartiesClient {
+    private readonly operatorKey;
+    private readonly agentId?;
+    private readonly baseUrl;
+    constructor(operatorKey: string, agentId?: string, baseUrl?: string);
+    /** Replace the notes; an empty string clears them. */
+    setNotes(partyId: string, notes: string): Promise<PartyNotesView>;
+}

package/dist/http/PartiesClient.js

@@ -0,0 +1,37 @@
+import { getBackendUrl } from '../utils/urlUtils.js';
+import { throwApiError } from '../shared/apiError.js';
+import { buildOperatorHeaders } from './operatorHeaders.js';
+/**
+ * A person who is not on Ziggs yet, as your workspace keeps them: someone it
+ * reaches by email or Slack. Only the workspace that vouches for them writes
+ * or reads what it knows about them.
+ */
+export class PartiesClient {
+    operatorKey;
+    agentId;
+    baseUrl;
+    constructor(operatorKey, agentId, baseUrl) {
+        if (!operatorKey) {
+            throw new Error('PartiesClient: operatorKey is required');
+        }
+        this.operatorKey = operatorKey;
+        this.agentId = agentId;
+        this.baseUrl = baseUrl || getBackendUrl();
+    }
+    /** Replace the notes; an empty string clears them. */
+    async setNotes(partyId, notes) {
+        const res = await fetch(`${this.baseUrl}/parties/${encodeURIComponent(partyId)}/notes`, {
+            method: 'PUT',
+            headers: {
+                ...buildOperatorHeaders(this.operatorKey, this.agentId),
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ notes }),
+        });
+        const text = await res.text().catch(() => '');
+        if (!res.ok) {
+            throwApiError(res, text, `PartiesClient.setNotes failed: ${res.status}`);
+        }
+        return JSON.parse(text);
+    }
+}

package/dist/http/index.d.ts

@@ -14,6 +14,7 @@ export type { ContextOpenKind, ContextOpenOutcome, ContextOpenRef, ContextOpenBo
 export { ContextDiscoveryClient } from './ContextDiscoveryClient.js';
 export type { DiscoverableItem } from './ContextDiscoveryClient.js';
 export { IntroductionsClient } from './IntroductionsClient.js';
+export { PartiesClient, type PartyNotesView } from './PartiesClient.js';
 export type { IntroductionView, IntroductionFrom, IntroductionStatus, IntroductionOutcome, MintIntroductionInput, } from './IntroductionsClient.js';
 export { GrantsClient } from './GrantsClient.js';
 export type { ListGrantsQuery, ListGrantsResult, UnreadableRail } from './GrantsClient.js';

package/dist/http/index.js

@@ -11,6 +11,7 @@ export { ContextReadClient, CONTEXT_READ_TYPES, CONTEXT_READ_VIA, VIA_KINDS, par
 export { ContextOpenClient, CONTEXT_OPEN_KINDS } from './ContextOpenClient.js';
 export { ContextDiscoveryClient } from './ContextDiscoveryClient.js';
 export { IntroductionsClient } from './IntroductionsClient.js';
+export { PartiesClient } from './PartiesClient.js';
 export { GrantsClient } from './GrantsClient.js';
 export { ContextGrantsClient } from './ContextGrantsClient.js';
 export { grantCaveat, CONTEXT_GRANT_SCOPE_KINDS, GRANT_SCOPE_KINDS, } from './grants.js';

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.37.12",
+  "version": "0.37.14",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
+  "homepage": "https://ziggsai.com/docs",
+  "bugs": {
+    "url": "https://ziggsai.com/support"
+  },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -36,17 +40,18 @@
     "client",
     "websocket"
   ],
-  "license": "MIT",
+  "license": "Apache-2.0",
   "files": [
     "dist",
     "README.md"
   ],
-  "homepage": "https://ziggsai.com/docs",
-  "bugs": {
-    "url": "https://ziggsai.com/support"
-  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ZiggsAI/sdk.git",
+    "directory": "api-client"
   }
 }