@ziggs-ai/agent-sdk 0.38.0 → 0.38.2

package/dist/Agent.js

@@ -1,3 +1,4 @@
+import { SERVER_EVENTS } from '@ziggs-ai/contracts';
 import { withAgreementContext } from './runtime/agreementContext.js';
 import { agreementLaneId, agreementIdFromLane, isContextAccessRequest } from '@ziggs-ai/api-client';
 import { createDeclaredPollRunner } from './platform/polls/declaredPollRunner.js';
@@ -556,7 +557,7 @@ export class Agent {
                 : undefined);
         const actorId = typeof event.actorId === 'string' && event.actorId ? event.actorId : undefined;
         return this.eventQueue.enqueue({
-            type: 'resource_changed',
+            type: SERVER_EVENTS.resourceChanged,
             resource: event,
             chatId: event.chatId,
             taskId: event.taskId,

package/dist/brain/claudeCognition.d.ts

@@ -1,16 +1,3 @@
-/**
- * Shared Claude-Agent-SDK cognition pieces.
- *
- * Everything a Claude-brain agent needs to turn a Ziggs wake into a `query()`
- * call, EXCEPT the loop itself. `ClaudeBrain` owns the loop (drive `query()`,
- * collect metrics); this module owns the periphery so it lives in one place and
- * is unit-testable without spinning up the SDK.
- *
- * The lockdown option set (`tools: []`, `strictMcpConfig`, `settingSources: []`,
- * bypass permissions, no local settings) is a security boundary, not a default —
- * it MUST be applied on every Claude-brain wake. Centralizing it here means a
- * caller cannot silently drift from it.
- */
 import { type Options, type SDKAssistantMessage } from '@anthropic-ai/claude-agent-sdk';
 import type { RawEvent } from '../runtime/buildOutcome.js';
 export interface ClaudeQueryOptionsParams {

package/dist/brain/claudeCognition.js

@@ -11,6 +11,7 @@
  * it MUST be applied on every Claude-brain wake. Centralizing it here means a
  * caller cannot silently drift from it.
  */
+import { SERVER_EVENTS } from '@ziggs-ai/contracts';
 import { SYSTEM_PROMPT_DYNAMIC_BOUNDARY, } from '@anthropic-ai/claude-agent-sdk';
 import { decisionWords } from '@ziggs-ai/api-client';
 import { getBatchEvents } from '../context/batch.js';
@@ -215,7 +216,7 @@ function renderEventLines(event, lines, now) {
     // store claim wakes as resource_changed (no chat, reason
     // proposal_approved). Distinct from the lifecycle hire path above: open the
     // buyer chat first, then greet and serve terms.
-    if (event?.type === 'resource_changed') {
+    if (event?.type === SERVER_EVENTS.resourceChanged) {
         const resource = (event.resource ?? event);
         const reason = (typeof resource.reason === 'string' && resource.reason) ||
             (typeof event.reason === 'string' && event.reason) ||

package/dist/brain/claudeSdkProtocol.js

@@ -27,7 +27,7 @@ Your prose and final summary are private host notes, not messages to the people
 - Closing a task closes the TASK, and only the task. It stores your result where the next agent reads it, queues a wake for whoever the platform addresses, and on an agreement that bills per completed task it meters that one execution. It does not end the hire — a standing agreement stays active for the next task — it does not prove anyone has read you, and it does not prove you were paid. The reply tells you which of those actually happened: report that and nothing beyond it. A completion whose reply you never saw is recovered by READING the task back, never by completing it a second time; your retry carries the same write key, so a redelivered completion no-ops instead of doubling the result, the wake and the charge.
 - Enumerate open work with \`task_list\` (use assignedToMe for your own active tasks).
 - Chat is where you talk to whoever you are working with, and where a human reads what you delivered — sending it to them there is delivery, not duplication. It is not where another AGENT collects a deliverable: that one reads the task result, so a chat message never stands in for closing the task. Deliver into the working conversation the hire already has; do not repeat it into every room you can reach.
-- Use any room you can write in, or open one (newChat for a separate subject). The server refuses what you are not allowed to do, and the refusal says why.
+- For replies and follow-ups, send into the original conversation (its chatId). Sending to a person without a chatId selects the main pair room, which may be a different conversation. Missing access is a reason to request the scoped permission, not to silently move the exchange. Use another writable room, or open one with newChat, only for a separate subject. The server refuses what you are not allowed to do, and the refusal says why.
 - When a store listing of yours is claimed (\`resource_changed\` with reason \`proposal_approved\`), call \`chat_open\` with the buyer (actorId / Sender) AND the claimed agreementId. That returns the hire's room, which the server usually made at claim, or opens one when there is none. Greet them only when the agreement accepts messages, then serve the agreement terms. A task-only agreement needs no chat or greeting: wait for assigned tasks and deliver results through tasks. Do not \`chat_send\` to an \`agrn-*\` session id — open a real chat first.
 - When a task you hold carries a deadline or a reminder rule, they are part of the job, not decoration. Never remind the same person sooner than the stated interval or more times than the budget; use \`wake_at\` to come back rather than waiting in place, and re-arm it each time you wake. When the budget is spent, stop asking and say what you have. At the deadline, post what you got and where you are stuck in the room where the question was asked, close the task, and stop — whether or not you got the answer. Nothing stops you from breaking this, which is exactly why it is on you: over-reminding is a breach of the task, not diligence, and every reminder costs a wake.
 - Hand off by completing your task — the platform notifies the next agent.

package/dist/brain/claudeSdkTools.js

@@ -74,7 +74,7 @@ export const chatSendTool = defineTool('chat_send', {
     underAgreementId: { type: 'string', description: 'Your run authority, defaulting to the current run in every destination room.' },
     chatId: { type: 'string', description: 'Omit this to send in the chat you were woken in — that is the usual case. Only pass a chatId to send in a DIFFERENT chat, such as one you just opened with chat_open. When chatId is set it wins over `to`.' },
     to: { type: 'string', description: 'User or agent id of someone you already have a conversation with. Sends in that pair room. Naming the person whose message woke you sends in the room that woke you instead, addressed to them. Does not open contact — first contact still needs chat_open. Ignored when chatId is set (chatId wins; `to` is used as receiverId if receiverId is omitted).' },
-    receiverId: { type: 'string', description: 'Name someone only when you mean them. Leave it out to write back in this room: one other participant is the recipient, and with several Jev may select one. Otherwise the message stays in the room with no specific wake. To name a masked party, pass its rpb_ ref as it came. Pass human to address the people in the room.' },
+    receiverId: { type: 'string', description: 'Name someone only when you mean them. Leave it out to write back in this room: one other participant is the recipient, and with several Jev may select one. Otherwise the message stays in the room with no specific wake. To name a masked party, pass its rpb_ ref as it came. Pass human only for a broadcast to the people in the room; it does not wake assistants or stand-ins. For a reply from a person or their assistant, name that person\'s returned participant id. This does not grant their assistant access or guarantee a reply.' },
     text: { type: 'string', required: true },
     idempotencyKey: { type: 'string', description: 'Reuse for retry-safe resend of the same logical message.' },
 }, async (args, ctx) => {

package/dist/brain/hireActivationNotice.js

@@ -7,6 +7,7 @@
  * manifest opts in. A hire a person formed (store claim) still wakes
  * so the provider can open the room and greet.
  */
+import { SERVER_EVENTS } from '@ziggs-ai/contracts';
 const ACTIVATION_LIFECYCLE_OPS = new Set([
     'proposal_approved',
     'proposal_approved_execute',
@@ -62,7 +63,7 @@ export function isHireActivationNotice(event) {
     if (type === 'agreement_lifecycle' && operation && ACTIVATION_LIFECYCLE_OPS.has(operation)) {
         return true;
     }
-    if (type !== 'resource_changed')
+    if (type !== SERVER_EVENTS.resourceChanged)
         return false;
     const resource = asRecord(ev.resource) ?? ev;
     const reason = typeof resource.reason === 'string' ? resource.reason : undefined;

package/dist/brain/standingOfferNotice.js

@@ -1,3 +1,4 @@
+import { SERVER_EVENTS } from '@ziggs-ai/contracts';
 import { isAgreementId, isBroadcastTarget } from '@ziggs-ai/api-client';
 import { getBatchEvents } from '../context/batch.js';
 function record(value) {
@@ -46,7 +47,7 @@ export async function filterStandingOfferNotices(event, agentId, readAgreement)
         const resource = record(item?.resource);
         const reason = resource?.reason ?? item?.reason;
         const id = agreementEventId(item);
-        if (item?.type === 'resource_changed' && resource?.kind === 'agreement' &&
+        if (item?.type === SERVER_EVENTS.resourceChanged && resource?.kind === 'agreement' &&
             (reason === 'approval:approved' || reason === 'proposal_approved') && id) {
             // Inconclusive reads preserve the wake. An unavailable read must not eat
             // a legitimate customer hire or the answer to an agent's own request.

package/dist/platform/inboxLoop.js

@@ -314,9 +314,6 @@ export async function pollInboxOnce(deps, waitSeconds = 0, opts = {}) {
             handledSoFar.add(request.agreementId);
         }
     }
-    if (envelope.truncatedRequests) {
-        warn(label, `inbox truncatedRequests=${envelope.truncatedRequests} (more requests than one pass surfaces — the tail follows on the next pass)`);
-    }
     // Pending decisions are standing state, not deliveries: they keep appearing
     // until answered, so dedup them the same way tasks are deduped.
     for (const proposal of envelope.proposalsAwaitingMe) {

package/dist/platform/tools/tier1/protocolRunner.js

@@ -1,3 +1,4 @@
+import { AGREEMENT_TERMINAL_STATES } from '@ziggs-ai/contracts';
 import { isBroadcastTarget, partyActorIds, presentClaimResult, } from '@ziggs-ai/api-client';
 // the link-summary rule lives in AgreementClient, at the point the
 // document is parsed. Every verb here inherits it through the client instead of
@@ -300,7 +301,7 @@ async function proposeAgreement(services, payload, chatId, writeKeys = null) {
 // party — instead of under that worker's sub-agreement, which the backend
 // rejects with 400 "assignee is not a party". Both are made deterministic here
 // using the chat's existing agreements.
-const TERMINAL_STATUS = new Set(['fulfilled', 'cancelled', 'refunded', 'rejected']);
+const TERMINAL_STATUS = new Set(AGREEMENT_TERMINAL_STATES);
 async function agreementsInChat(services, chatId, cachedAgreements) {
     if (!chatId)
         return [];

package/dist/runtime/buildOutcome.js

@@ -1,3 +1,4 @@
+import { SERVER_EVENTS } from '@ziggs-ai/contracts';
 import { isProtocolToolName, mapProtocolToolToOperation } from '../tasks/protocolRegistry.js';
 import { getBatchEvents, isTaskResultRelevantToAgent } from '../context/batch.js';
 import { bookForDelegation, ensureTaskBook, findBookHoldingPending, removeTaskBook, } from './taskBookkeeping.js';
@@ -108,7 +109,7 @@ function singleEventToOutcome(ev, ownAgentId) {
         }
         return { kind: 'subtask-finished', status: 'completed', task, result };
     }
-    if (ev.type === 'resource_changed') {
+    if (ev.type === SERVER_EVENTS.resourceChanged) {
         const resource = (ev.resource ?? ev);
         const reason = resource.reason;
         if (resource.kind === 'agreement' &&

package/dist/shared/types.d.ts

@@ -1,3 +1,6 @@
+import { ContentTypes, type ContentType } from '@ziggs-ai/api-client';
+export { ContentTypes, type ContentType };
+/** Entry kinds. `task_history` is a legacy alias the wire still accepts. */
 export declare const EntryTypes: {
     readonly MESSAGE: "message";
     readonly NOTIFICATION: "notification";
@@ -5,15 +8,6 @@ export declare const EntryTypes: {
     readonly TASK_HISTORY: "task_history";
 };
 export type EntryType = (typeof EntryTypes)[keyof typeof EntryTypes];
-export declare const ContentTypes: {
-    readonly TEXT: "text";
-    readonly OPERATION: "operation";
-    readonly CONTEXT: "context";
-    readonly RESULT: "result";
-    readonly TASK_UPDATE: "task_update";
-    readonly THOUGHT: "thought";
-};
-export type ContentType = (typeof ContentTypes)[keyof typeof ContentTypes];
 export declare const ContextProperties: {
     readonly HISTORY: "history";
     readonly AGREEMENTS: "agreements";

package/dist/shared/types.js

@@ -1,20 +1,12 @@
-// Inlined from `@ziggs-ai/api-client` so the pure SDK doesn't depend on the
-// Ziggs HTTP client. Both client and server agree on these string constants
-// because the protocol is the same — they're just two views of one schema.
+import { ContentTypes } from '@ziggs-ai/api-client';
+export { ContentTypes };
+/** Entry kinds. `task_history` is a legacy alias the wire still accepts. */
 export const EntryTypes = {
     MESSAGE: 'message',
     NOTIFICATION: 'notification',
     ARTIFACT: 'artifact',
     TASK_HISTORY: 'task_history',
 };
-export const ContentTypes = {
-    TEXT: 'text',
-    OPERATION: 'operation',
-    CONTEXT: 'context',
-    RESULT: 'result',
-    TASK_UPDATE: 'task_update',
-    THOUGHT: 'thought',
-};
 export const ContextProperties = {
     HISTORY: 'history',
     AGREEMENTS: 'agreements',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/agent-sdk",
-  "version": "0.38.0",
+  "version": "0.38.2",
   "description": "Agent framework SDK for building autonomous agents on the Ziggs platform",
   "type": "module",
   "main": "dist/index.js",
@@ -26,7 +26,8 @@
     "@anthropic-ai/claude-agent-sdk": "^0.3.284",
     "@anthropic-ai/sdk": "^0.110.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@ziggs-ai/api-client": "0.37.0",
+    "@ziggs-ai/api-client": "0.37.4",
+    "@ziggs-ai/contracts": "^0.23.3",
     "ajv": "^8.17.1",
     "dotenv": "^17.2.3",
     "openai": "^4.0.0",