@ziggs-ai/agent-sdk 0.16.1 → 0.18.0

package/dist/{agent → brain}/claudeSdkTools.d.ts

@@ -1,5 +1,5 @@
 import { type ToolDefinition } from '../tools/defineTool.js';
-import { listTasksTool } from '../server/tools/tier2/taskTools.js';
+import { listTasksTool } from '../platform/tools/tier2/taskTools.js';
 import type { EffectHandler, DeliveryWriteKeys } from '../types.js';
 export interface ClaudeSdkToolContext extends Record<string, unknown> {
     operatorKey: string;

package/dist/{agent → brain}/claudeSdkTools.js

@@ -1,10 +1,11 @@
+import { isAgreementId, agreementLaneId, isRoomPresentationRef as isRoomParticipantRef } from '@ziggs-ai/api-client';
 import { randomUUID } from 'node:crypto';
 import { credsFromToolContext } from '../tools/toolCreds.js';
 import { sendChatMessage } from '@ziggs-ai/api-client';
 import { defineTool } from '../tools/defineTool.js';
-import { listGrantsTool } from '../server/tools/tier2/grantsTools.js';
-import { listTasksTool } from '../server/tools/tier2/taskTools.js';
-import { CHAT_TOOLS } from '../server/tools/tier2/chatTools.js';
+import { listGrantsTool } from '../platform/tools/tier2/grantsTools.js';
+import { listTasksTool } from '../platform/tools/tier2/taskTools.js';
+import { CHAT_TOOLS } from '../platform/tools/tier2/chatTools.js';
 // default message-history cap. An uncapped snapshot returns the whole
 // chat — in a delegation chat that accumulates notification rows, every wake's
 // snapshot ballooned (observed 35–47k input tokens/wake, ~205k/run). 12 recent
@@ -42,7 +43,7 @@ function firstFilled(...candidates) {
  * between a wasted turn and an answer.
  */
 function asChatLane(id) {
-    return id?.startsWith('agr_') ? `agrn-${id}` : id;
+    return isAgreementId(id) ? agreementLaneId(id) : id;
 }
 // Named distinctly from ziggs-mcp's per-type `ziggs_context_read`: this is the
 // one-shot aggregate snapshot (grant-fenced server-side), not a cursored read.
@@ -67,16 +68,6 @@ export const contextSnapshotTool = defineTool('context_snapshot', {
         },
     });
 }, { description: 'Read the chat snapshot: the NEWEST maxMessages of history (chronological order), plus agreements, agents, and users for a session.' });
-/**
- * A room participant reference (`rpb_*`) — the persona layer's masked address.
- *
- * It names one subject INSIDE ONE ROOM and is minted per room, so it is an
- * address there and nowhere else. Kept as a local prefix test rather than an
- * import: the SDK talks to the backend over HTTP and shares no code with it.
- */
-function isRoomParticipantRef(id) {
-    return typeof id === 'string' && id.startsWith('rpb_');
-}
 export const chatSendTool = defineTool('chat_send', {
     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. 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).' },

package/dist/{agent → brain}/hostedAgentConnection.d.ts

@@ -1,5 +1,5 @@
 /**
- * Hosted fleet agents connect via api-client (AgentHost), never inbound ziggs-mcp.
+ * Hosted fleet agents connect via api-client (Agent), never inbound ziggs-mcp.
  * @see
  */
 export type McpServerSpec = {

package/dist/{agent → brain}/hostedAgentConnection.js

@@ -1,5 +1,5 @@
 /**
- * Hosted fleet agents connect via api-client (AgentHost), never inbound ziggs-mcp.
+ * Hosted fleet agents connect via api-client (Agent), never inbound ziggs-mcp.
  * @see
  */
 export function looksLikeInboundZiggsMcp(command, args = []) {
@@ -19,11 +19,11 @@ export function assertHostedAgentZiggsTools(mcpServers) {
         const spec = raw;
         if (spec.type === 'stdio') {
             throw new Error(`Hosted Ziggs agents must not use stdio MCP (server "${name}"). ` +
-                'Connect via api-client / AgentHost in-process tools.');
+                'Connect via api-client / Agent in-process tools.');
         }
         if (looksLikeInboundZiggsMcp(String(spec.command ?? ''), spec.args ?? [])) {
             throw new Error(`Hosted Ziggs agents must not spawn ziggs-mcp (inbound MCP server "${name}"). ` +
-                'Use AgentHost + in-process tools.');
+                'Use Agent + in-process tools.');
         }
     }
 }

package/dist/brain/index.d.ts

@@ -1,13 +1,13 @@
-import type { TickInput, TickOutput } from '../agent/Agent.js';
+import type { TickInput, TickOutput } from './ZiggsBrain.js';
 /**
  * Public brain contract — how an agent decides on each wake.
- * {@link Agent} (Ziggs workflow/FSM) and {@link ClaudeSdkAgent} both implement this.
+ * {@link ZiggsBrain} (Ziggs workflow/FSM) and {@link ClaudeBrain} both implement this.
  */
 export interface Brain {
     readonly kind: 'ziggs' | 'claude';
     tick(input: TickInput): Promise<TickOutput>;
 }
-/** Config carried by {@link ziggsBrain} — workflow stays on the host. */
+/** Config carried by {@link ziggsBrain} — workflow is declared on the agent. */
 export interface ZiggsBrainConfig {
     /** Model id — `claude-*` routes to Anthropic, else OpenAI. */
     model?: string;
@@ -18,7 +18,7 @@ export interface ZiggsBrainConfig {
 export interface ClaudeBrainConfig {
     anthropicKey?: string;
     model?: string;
-    /** Max agentic turns per Claude SDK wake. Host default applies when omitted. */
+    /** Max agentic turns per Claude SDK wake. Agent default applies when omitted. */
     maxTurns?: number;
     /** Persona line injected into the Claude system prompt. */
     specialization?: string | null;
@@ -35,8 +35,8 @@ export declare function ziggsBrain(config?: ZiggsBrainConfig): BrainSelection;
 /** Pick the Claude Agent SDK brain (autonomous query() loop). */
 export declare function claudeBrain(config?: ClaudeBrainConfig): BrainSelection;
 export declare function isBrainSelection(value: unknown): value is BrainSelection;
-/** Map public `brain` + legacy `cognition` into normalized host options. */
-export declare function applyBrainToHostOptions<T extends {
+/** Map public `brain` + legacy `cognition` into normalized agent options. */
+export declare function applyBrainToAgentOptions<T extends {
     brain?: BrainSelection;
     cognition?: 'fsm' | 'claude-sdk';
     model?: string;

package/dist/brain/index.js

@@ -14,8 +14,8 @@ export function isBrainSelection(value) {
     const kind = value.kind;
     return kind === 'ziggs' || kind === 'claude';
 }
-/** Map public `brain` + legacy `cognition` into normalized host options. */
-export function applyBrainToHostOptions(options) {
+/** Map public `brain` + legacy `cognition` into normalized agent options. */
+export function applyBrainToAgentOptions(options) {
     const brain = options.brain;
     if (!brain) {
         return { ...options, cognition: options.cognition ?? 'fsm' };

package/dist/brain/onBehalfAgreement.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Which agreement a wake may act under for on-behalf / mandate.
+ *
+ * A wake binds to the contract where this agent is the **provider**, never to a
+ * sub it pays for. Worker-result events name the sub; using that id made the
+ * next purchase stamp the operator as payer.
+ *
+ * Pure: no lineage walk. Candidates the wire already named are kept only when
+ * context shows the agent on the provider side (or the row is unknown). A known
+ * payer-only row is skipped. Fallback is still "exactly one active provider hire".
+ */
+export type OnBehalfParties = {
+    provider?: {
+        actor?: string | null;
+    } | null;
+    payer?: {
+        actor?: string | null;
+        principal?: string | null;
+    } | null;
+};
+export type OnBehalfAgreementRow = {
+    agreementId?: unknown;
+    id?: unknown;
+    _id?: unknown;
+    status?: unknown;
+    providerId?: unknown;
+    providerAgentId?: unknown;
+    executorId?: unknown;
+    parties?: OnBehalfParties | null;
+};
+export type RawOnBehalfEvent = {
+    agreementId?: unknown;
+    result?: {
+        agreementId?: unknown;
+    } | null;
+};
+/** Is this agent on the provider side of the row? */
+export declare function agentProvidesOn(row: OnBehalfAgreementRow, agentId: string): boolean;
+/** Is this agent standing on the paying side (actor), not as provider? */
+export declare function agentPaysOn(row: OnBehalfAgreementRow, agentId: string): boolean;
+/**
+ * May this wire-named agreement be used as on-behalf for `agentId`?
+ * - provider on the row → yes
+ * - payer-only on the row → no
+ * - row missing from context → yes (unknown; do not invent a parent)
+ */
+export declare function mayBindOnBehalf(agreementId: string, agentId: string | null | undefined, rows: OnBehalfAgreementRow[]): boolean;
+/**
+ * Resolve the agreement id this wake should declare for on-behalf / mandate.
+ */
+export declare function resolveOnBehalfAgreementId(rawEvent: RawOnBehalfEvent | undefined, contextAgreements: OnBehalfAgreementRow[] | null | undefined, agentId: string | null | undefined, sessionId: string | null | undefined): string | undefined;

package/dist/brain/onBehalfAgreement.js

@@ -0,0 +1,99 @@
+/**
+ * Which agreement a wake may act under for on-behalf / mandate.
+ *
+ * A wake binds to the contract where this agent is the **provider**, never to a
+ * sub it pays for. Worker-result events name the sub; using that id made the
+ * next purchase stamp the operator as payer.
+ *
+ * Pure: no lineage walk. Candidates the wire already named are kept only when
+ * context shows the agent on the provider side (or the row is unknown). A known
+ * payer-only row is skipped. Fallback is still "exactly one active provider hire".
+ */
+function asId(v) {
+    return typeof v === 'string' && v ? v : undefined;
+}
+function rowId(a) {
+    return asId(a.agreementId) ?? asId(a.id) ?? asId(a._id);
+}
+function isTerminalStatus(status) {
+    const s = status != null ? String(status).toLowerCase() : '';
+    return s === 'cancelled' || s === 'refunded' || s === 'fulfilled';
+}
+function isActiveStatus(status) {
+    const s = status != null ? String(status).toLowerCase() : '';
+    return s === 'active' || s === 'approved' || s === '';
+}
+/** Is this agent on the provider side of the row? */
+export function agentProvidesOn(row, agentId) {
+    const provider = row.parties?.provider;
+    const providerIds = [
+        provider?.actor,
+        row.providerId,
+        row.providerAgentId,
+        row.executorId,
+    ];
+    return providerIds.some((x) => x === agentId);
+}
+/** Is this agent standing on the paying side (actor), not as provider? */
+export function agentPaysOn(row, agentId) {
+    if (agentProvidesOn(row, agentId))
+        return false;
+    return row.parties?.payer?.actor === agentId;
+}
+function findRow(agreementId, rows) {
+    return rows.find((a) => rowId(a) === agreementId);
+}
+/**
+ * May this wire-named agreement be used as on-behalf for `agentId`?
+ * - provider on the row → yes
+ * - payer-only on the row → no
+ * - row missing from context → yes (unknown; do not invent a parent)
+ */
+export function mayBindOnBehalf(agreementId, agentId, rows) {
+    if (!agentId)
+        return true;
+    const row = findRow(agreementId, rows);
+    if (!row)
+        return true;
+    if (agentProvidesOn(row, agentId))
+        return true;
+    if (agentPaysOn(row, agentId))
+        return false;
+    return true;
+}
+function singleActiveProviderHire(rows, agentId) {
+    const provides = rows.filter((a) => {
+        if (!agentProvidesOn(a, agentId))
+            return false;
+        if (isTerminalStatus(a.status))
+            return false;
+        return isActiveStatus(a.status);
+    });
+    if (provides.length !== 1)
+        return undefined;
+    return rowId(provides[0]);
+}
+/**
+ * Resolve the agreement id this wake should declare for on-behalf / mandate.
+ */
+export function resolveOnBehalfAgreementId(rawEvent, contextAgreements, agentId, sessionId) {
+    const rows = Array.isArray(contextAgreements) ? contextAgreements : [];
+    const candidates = [];
+    const fromResult = asId(rawEvent?.result?.agreementId);
+    if (fromResult)
+        candidates.push(fromResult);
+    const fromEvent = asId(rawEvent?.agreementId);
+    if (fromEvent && fromEvent !== fromResult)
+        candidates.push(fromEvent);
+    if (typeof sessionId === 'string' && sessionId.startsWith('agr_')) {
+        if (!candidates.includes(sessionId))
+            candidates.push(sessionId);
+    }
+    for (const id of candidates) {
+        if (!agentId || mayBindOnBehalf(id, agentId, rows))
+            return id;
+    }
+    if (agentId)
+        return singleActiveProviderHire(rows, agentId);
+    return undefined;
+}

package/dist/{agent → brain}/toolManagerToSdkMcp.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { createSdkMcpServer } from '@anthropic-ai/claude-agent-sdk';
+import { withDeclaredMandate } from '../runtime/mandateDeclaration.js';
 function jsonTypeToZod(field) {
     const t = field['type'];
     if (t === 'string') {
@@ -102,9 +103,17 @@ export function buildSdkToolDefs(toolDefs, getContext) {
             handler: async (args) => {
                 try {
                     const ctx = getContext();
-                    const payload = args._ != null && Object.keys(args).length === 1
+                    const payloadRaw = args._ != null && Object.keys(args).length === 1
                         ? args._
                         : args;
+                    const payload = withDeclaredMandate(payloadRaw ?? {}, name, {
+                        getTool: (toolName) => {
+                            const found = toolDefs.find((d) => String(d.schema.function['name'] ?? '') === toolName);
+                            return found ? { schema: found.schema } : undefined;
+                        },
+                    }, typeof ctx.onBehalfOfAgreementId === 'string'
+                        ? ctx.onBehalfOfAgreementId
+                        : null);
                     const eff = ctx.eff;
                     if (!eff)
                         return toCallToolError(`tool "${name}": missing eff in tool context`);

package/dist/defineAgent.js

@@ -2,7 +2,7 @@ import { validateWorkflow } from './runtime/validateWorkflow.js';
 import { injectKickoffDefault } from './runtime/kickoff.js';
 import { injectTaskIntakeDefault } from './runtime/taskIntake.js';
 import { runtimeLog } from './shared/runtimeLog.js';
-import { DEFAULT_MODEL } from './AgentHost.js';
+import { DEFAULT_MODEL } from './Agent.js';
 import { normalizeNeeds, toolsForNeeds } from './tools/needs.js';
 import { toolName } from './tools/defineTool.js';
 /**
@@ -76,13 +76,13 @@ export function defineAgent(input) {
     }
     // Model resolution, most-specific-first: a per-agent pin, then the
     // fleet-wide `LLM_MODEL` lever, then the single `DEFAULT_MODEL` fallback (the
-    // ONE place the default lives — see AgentHost). The id also picks the provider
+    // ONE place the default lives — see Agent). The id also picks the provider
     // (claude-* → Anthropic). No agent hardcodes its own fallback.
     const model = input.services?.llm?.model ||
         process.env.LLM_MODEL ||
         DEFAULT_MODEL;
     // Strip the structural fields we already consumed; pass through everything
-    // else (operatorKey, taskTools, custom keys consumed by AgentHost).
+    // else (operatorKey, taskTools, custom keys consumed by Agent).
     const { agentId, description, specialization, services: _services, initial: _initial, states: _states, tools: _tools, operatorKey, taskTools, ...rest } = input;
     const config = {
         openaiKey: process.env.OPENAI_API_KEY,
@@ -102,7 +102,7 @@ export function defineAgent(input) {
         ...(input.services ? { services: input.services } : {}),
         ...(taskTools !== undefined ? { taskTools } : {}),
         ...rest,
-        // After `rest`, so the config carries the NORMALIZED needs — AgentHost
+        // After `rest`, so the config carries the NORMALIZED needs — Agent
         // enforces these at task start and should not have to re-parse the raw field.
         ...(needs.length ? { needs } : {}),
     };

package/dist/formatters/HistoryFormatter.js

@@ -1,3 +1,4 @@
+import { isOpaquePresentationRef } from '@ziggs-ai/api-client';
 import { partySideIds } from '@ziggs-ai/api-client';
 export class HistoryFormatter {
     showTimestamps;
@@ -136,7 +137,7 @@ export class HistoryFormatter {
                 : null);
         if (faceName)
             return `${faceName} (${id})`;
-        if (id.startsWith('rpb_') || id.startsWith('psn_')) {
+        if (isOpaquePresentationRef(id)) {
             return `${id} (presentation)`;
         }
         return `${id} (${participant['type'] || 'unknown'})`;

package/dist/index.d.ts

@@ -8,28 +8,29 @@
  *   • Validation at load — defineAgent throws on hard problems, warns on soft
  */
 export { defineAgent } from './defineAgent.js';
-export { createMcpAgent, resolveZiggsGatewayTarget, wrapGatewayFetch, ZiggsGatewayError } from './adapters/McpAdapter.js';
-export type { CreateMcpAgentOptions, McpAgentHandle, McpTransportConfig } from './adapters/McpAdapter.js';
-export { parseSkill, skillHash, skillRolePrompt, splitFrontmatter, SkillValidationError, SKILL_MAX_CHARS, } from './skills/parseSkill.js';
+export { createMcpAgent, resolveZiggsGatewayTarget, wrapGatewayFetch, ZiggsGatewayError } from './mcp/createMcpAgent.js';
+export type { CreateMcpAgentOptions, McpAgentHandle, McpTransportConfig } from './mcp/createMcpAgent.js';
+export { parseSkill, skillHash, skillRolePrompt, skillReferenceName, skillReferenceOneLine, splitFrontmatter, SkillValidationError, SKILL_MAX_CHARS, } from './skills/parseSkill.js';
 export type { ParsedSkill, SkillFile, SkillReference } from './skills/parseSkill.js';
 export { loadSkill, readSkillFiles, assertSkillHash } from './skills/loadSkill.js';
-export { AgentHost, createAgent, createAgentPool, DEFAULT_MODEL } from './AgentHost.js';
-export { Agent } from './agent/Agent.js';
-export { ClaudeSdkAgent } from './agent/ClaudeSdkAgent.js';
-export type { CognitionKind } from './agent/ClaudeSdkAgent.js';
-export { CLAUDE_SDK_PROTOCOL } from './agent/claudeSdkProtocol.js';
-export { buildClaudeEventPrompt, summarizeContext } from './agent/claudeCognition.js';
+export { skillReadReferenceTool } from './skills/skillReadReference.js';
+export { Agent, createAgent, createAgentPool, DEFAULT_MODEL } from './Agent.js';
+export { ZiggsBrain } from './brain/ZiggsBrain.js';
+export { ClaudeBrain } from './brain/ClaudeBrain.js';
+export type { CognitionKind, ClaudeBrainOptions } from './brain/ClaudeBrain.js';
+export { CLAUDE_SDK_PROTOCOL } from './brain/claudeSdkProtocol.js';
+export { buildClaudeEventPrompt, summarizeContext } from './brain/claudeCognition.js';
 export { ziggsBrain, claudeBrain, isBrainSelection, isClaudeCognition } from './brain/index.js';
 export type { Brain, BrainSelection, ZiggsBrainConfig, ClaudeBrainConfig, } from './brain/index.js';
-export type { TickInput, TickOutput, AgentOptions } from './agent/Agent.js';
-export type { SessionResolver, AgentHostOptions, WakeRecord } from './AgentHost.js';
-export { createZiggsEffectHandler } from './server/ZiggsEffectHandler.js';
-export type { ZiggsEffectDeps } from './server/ZiggsEffectHandler.js';
-export { EventQueue } from './server/EventQueue.js';
-export type { EventQueueBusyLane, WaitForIdleResult } from './server/EventQueue.js';
-export { StateTimers } from './server/StateTimers.js';
-export type { StateTimeoutEvent } from './server/StateTimers.js';
-export { OutboxBuffer } from './server/OutboxBuffer.js';
+export type { TickInput, TickOutput, ZiggsBrainOptions } from './brain/ZiggsBrain.js';
+export type { SessionResolver, AgentOptions, WakeRecord } from './Agent.js';
+export { createZiggsEffectHandler } from './platform/ZiggsEffectHandler.js';
+export type { ZiggsEffectDeps } from './platform/ZiggsEffectHandler.js';
+export { EventQueue } from './platform/EventQueue.js';
+export type { EventQueueBusyLane, WaitForIdleResult } from './platform/EventQueue.js';
+export { StateTimers } from './platform/StateTimers.js';
+export type { StateTimeoutEvent } from './platform/StateTimers.js';
+export { OutboxBuffer } from './platform/OutboxBuffer.js';
 export { normalizeIncomingEvent } from './ingress/normalizeIncoming.js';
 export { AgentMachine, type TransitionEvent } from './runtime/AgentMachine.js';
 export { runTurn } from './runtime/runTurn.js';
@@ -42,14 +43,12 @@ export { outcomeFromEvent, outcomeFromActionResult, applyOutcomeToCtx } from './
 export { LANE_BOOK_KEY, allCollectedResults, allDelegatedAgreementIds, allPendingSubtasks, } from './runtime/taskBookkeeping.js';
 export { createDeliveryWriteKeys } from './runtime/deliveryWriteKeys.js';
 export type { Outcome, OutcomeKind, Ctx, Identity, HistoryEntry, ToolResultEntry, PendingSubtask, CollectedSubtaskResult, TaskBookkeeping, Workflow, State, ParkedState, ThinkingState, MechanicalState, Action, Transition, PromptDef, ActionPrompt, Produces, ProducesFn, AgreementRef, TaskRef, ProposalRef, AgentConfig, DefineAgentInput, ServicesConfig, Effect, EffectKind, EffectResult, EffectResultMap, EffectHandler, LlmMessage, LlmToolCall, LlmToolSchema, LlmResponse, ContextSnapshot, SnapshotParticipant, ReadContextOpts, ToolCallResult, RecordedEntry, DeliveryWriteKeys, } from './types.js';
-export { default } from './AgentHost.js';
+export { default } from './Agent.js';
 export { validateContext, ContextWarning } from './cognition/validateContext.js';
-export { runLauncher } from './server/runLauncher.js';
-export { ConnectionPool } from './server/ConnectionPool.js';
+export { ConnectionPool } from './platform/ConnectionPool.js';
 export { decodeOperatorKeyClaims, boundKeyFleetWarning } from './shared/operatorKeyClaims.js';
-export { createHealthServer } from './server/createHealthServer.js';
-export { TaskService } from './server/tasks/TaskService.js';
-export { AgreementService } from './server/agreements/AgreementService.js';
+export { TaskService } from './platform/tasks/TaskService.js';
+export { AgreementService } from './platform/agreements/AgreementService.js';
 export { ToolManager } from './tools/ToolManager.js';
 export { ToolProvider } from './tools/ToolProvider.js';
 export { defineTool } from './tools/defineTool.js';
@@ -61,21 +60,21 @@ export type { AgentNeed, ConnectionNeed } from './tools/needs.js';
 export { OpenAIAdapter } from './adapters/OpenAIAdapter.js';
 export { extractJSON, safeParseJSON } from './utils/jsonExtractor.js';
 export { HistoryFormatter, historyFormatter, AgreementFormatter, agreementFormatter } from './formatters/index.js';
-export { ProactiveTrigger } from './server/proactive/ProactiveTrigger.js';
-export { PollRegistry, declaredPolls, type PollBinding, type PollContext, type PollKind, type PollResult, } from './server/polls/PollKind.js';
-export { PollRunner, type PollRunnerOptions, type WakeTarget } from './server/polls/PollRunner.js';
-export { PROTOCOL_TOOLS, agreementProposeTool, agreementSubcontractTool, agreementRespondTool, agreementClaimTool, agreementCounterTool, agreementGetTool, agreementRevokeTool, agreementFulfillTool, taskCreateTool, taskSetResultTool, taskUpdatePlanStepTool, dispatchProtocolOp, PAYMENT_TOOLS, paymentBalanceTool, CONNECTION_TOOLS, connectionProxyTool, connectionListGrantsTool, requestConnectionTool, MCP_CONNECTION_TOOLS, mcpToolCallTool, mcpToolsListTool, DISCOVERY_TOOLS, agentSearchTool, agentGetTool, MARKETPLACE_TOOLS, marketplaceViewTool, CONTEXT_TOOLS, contextReadTool, contextDelegateTool, contextExpandReachTool, contextDiscoverGrantableTool, GRANTS_TOOLS, listGrantsTool, LINK_TOOLS, linkProposeTool, linkListTool, INTRODUCTION_TOOLS, introductionMintTool, introductionRedeemTool, introductionListTool, introductionRevokeTool, ARTIFACT_TOOLS, recordArtifactTool, CHAT_TOOLS, openConversationTool, } from './server/tools/index.js';
-export { CLAUDE_SDK_TOOLS } from './agent/claudeSdkTools.js';
+export { ProactiveTrigger } from './platform/proactive/ProactiveTrigger.js';
+export { PollRegistry, declaredPolls, type PollBinding, type PollContext, type PollKind, type PollResult, } from './platform/polls/PollKind.js';
+export { PollRunner, type PollRunnerOptions, type WakeTarget } from './platform/polls/PollRunner.js';
+export { PROTOCOL_TOOLS, agreementProposeTool, agreementSubcontractTool, agreementRespondTool, agreementClaimTool, agreementCounterTool, agreementGetTool, agreementRevokeTool, agreementFulfillTool, taskCreateTool, taskSetResultTool, taskUpdatePlanStepTool, dispatchProtocolOp, PAYMENT_TOOLS, paymentBalanceTool, CONNECTION_TOOLS, connectionProxyTool, connectionListGrantsTool, requestConnectionTool, MCP_CONNECTION_TOOLS, mcpToolCallTool, mcpToolsListTool, DISCOVERY_TOOLS, agentSearchTool, agentGetTool, MARKETPLACE_TOOLS, marketplaceViewTool, CONTEXT_TOOLS, contextReadTool, contextDelegateTool, contextExpandReachTool, contextDiscoverGrantableTool, GRANTS_TOOLS, listGrantsTool, LINK_TOOLS, linkProposeTool, linkListTool, INTRODUCTION_TOOLS, introductionMintTool, introductionRedeemTool, introductionListTool, introductionRevokeTool, ARTIFACT_TOOLS, recordArtifactTool, CHAT_TOOLS, openConversationTool, } from './platform/tools/index.js';
+export { CLAUDE_SDK_TOOLS } from './brain/claudeSdkTools.js';
 export { PROTOCOL_TOOL_NAMES, PROTOCOL_TOOL_TO_OPERATION, mapProtocolToolToOperation, isProtocolToolName } from './tasks/protocolRegistry.js';
 export { InMemoryStore, FileMemoryStore } from './memory/MemoryStore.js';
 export type { MemoryStore } from './memory/MemoryStore.js';
-export type { SessionStore } from './AgentHost.js';
+export type { SessionStore } from './Agent.js';
 export { classifyIncomingEvent } from './context/classifyEnvelope.js';
 export { buildContextUpdates, CONTEXT_RESET } from './context/applyEffects.js';
 export { getBatchEvents, isTaskResultRelevantToAgent } from './context/batch.js';
 export { classifyWorkflowEvent, findTaskResult, unwrapBatchEvent, findIncomingTaskResult } from './context/routingLabels.js';
 export { MessagesClient, ArtifactsClient, AgentSearchClient, getBackendUrl, configureApiClient, } from '@ziggs-ai/api-client';
 export type { ApiClientConfig } from '@ziggs-ai/api-client';
-export { SeenMessages } from './server/SeenMessages.js';
+export { SeenMessages } from './platform/SeenMessages.js';
 export { runtimeLog, resetRuntimeLogLevelCache } from './shared/runtimeLog.js';
 export type { RuntimeLogLevel } from './shared/runtimeLog.js';

package/dist/index.js

@@ -8,28 +8,29 @@
  *   • Validation at load — defineAgent throws on hard problems, warns on soft
  */
 export { defineAgent } from './defineAgent.js';
-export { createMcpAgent, resolveZiggsGatewayTarget, wrapGatewayFetch, ZiggsGatewayError } from './adapters/McpAdapter.js';
+export { createMcpAgent, resolveZiggsGatewayTarget, wrapGatewayFetch, ZiggsGatewayError } from './mcp/createMcpAgent.js';
 // Skills: packaged instructions (SKILL.md + optional references/*.md) that
 // become an agent's systemPrompt. Parse-validate-pin is the whole machinery;
 // wiring one into an agent is a spread into claudeSdkAgentBase/createMcpAgent.
 // Prompt-baked — never the SDK's native skill loader.
-export { parseSkill, skillHash, skillRolePrompt, splitFrontmatter, SkillValidationError, SKILL_MAX_CHARS, } from './skills/parseSkill.js';
+export { parseSkill, skillHash, skillRolePrompt, skillReferenceName, skillReferenceOneLine, splitFrontmatter, SkillValidationError, SKILL_MAX_CHARS, } from './skills/parseSkill.js';
 export { loadSkill, readSkillFiles, assertSkillHash } from './skills/loadSkill.js';
-export { AgentHost, createAgent, createAgentPool, DEFAULT_MODEL } from './AgentHost.js';
-export { Agent } from './agent/Agent.js';
-export { ClaudeSdkAgent } from './agent/ClaudeSdkAgent.js';
+export { skillReadReferenceTool } from './skills/skillReadReference.js';
+export { Agent, createAgent, createAgentPool, DEFAULT_MODEL } from './Agent.js';
+export { ZiggsBrain } from './brain/ZiggsBrain.js';
+export { ClaudeBrain } from './brain/ClaudeBrain.js';
 // The exact strings a Claude-brain wake sends: the shared protocol block, the
 // role-independent event prompt, and the one-line context digest. Exported so a
 // caller can answer "what does this agent actually put in front of the model,
 // and what does it cost?" without re-deriving it — a second copy of the prompt
 // is a second answer to that question, and only one of them would be true.
-export { CLAUDE_SDK_PROTOCOL } from './agent/claudeSdkProtocol.js';
-export { buildClaudeEventPrompt, summarizeContext } from './agent/claudeCognition.js';
+export { CLAUDE_SDK_PROTOCOL } from './brain/claudeSdkProtocol.js';
+export { buildClaudeEventPrompt, summarizeContext } from './brain/claudeCognition.js';
 export { ziggsBrain, claudeBrain, isBrainSelection, isClaudeCognition } from './brain/index.js';
-export { createZiggsEffectHandler } from './server/ZiggsEffectHandler.js';
-export { EventQueue } from './server/EventQueue.js';
-export { StateTimers } from './server/StateTimers.js';
-export { OutboxBuffer } from './server/OutboxBuffer.js';
+export { createZiggsEffectHandler } from './platform/ZiggsEffectHandler.js';
+export { EventQueue } from './platform/EventQueue.js';
+export { StateTimers } from './platform/StateTimers.js';
+export { OutboxBuffer } from './platform/OutboxBuffer.js';
 export { normalizeIncomingEvent } from './ingress/normalizeIncoming.js';
 // Runtime primitives
 export { AgentMachine } from './runtime/AgentMachine.js';
@@ -42,15 +43,13 @@ export { validateWorkflow, WorkflowValidationError } from './runtime/validateWor
 export { outcomeFromEvent, outcomeFromActionResult, applyOutcomeToCtx } from './runtime/buildOutcome.js';
 export { LANE_BOOK_KEY, allCollectedResults, allDelegatedAgreementIds, allPendingSubtasks, } from './runtime/taskBookkeeping.js';
 export { createDeliveryWriteKeys } from './runtime/deliveryWriteKeys.js';
-export { default } from './AgentHost.js';
+export { default } from './Agent.js';
 // ── Supporting modules ──────────────────────────────────────────────────────
 export { validateContext, ContextWarning } from './cognition/validateContext.js';
-export { runLauncher } from './server/runLauncher.js';
-export { ConnectionPool } from './server/ConnectionPool.js';
+export { ConnectionPool } from './platform/ConnectionPool.js';
 export { decodeOperatorKeyClaims, boundKeyFleetWarning } from './shared/operatorKeyClaims.js';
-export { createHealthServer } from './server/createHealthServer.js';
-export { TaskService } from './server/tasks/TaskService.js';
-export { AgreementService } from './server/agreements/AgreementService.js';
+export { TaskService } from './platform/tasks/TaskService.js';
+export { AgreementService } from './platform/agreements/AgreementService.js';
 export { ToolManager } from './tools/ToolManager.js';
 export { ToolProvider } from './tools/ToolProvider.js';
 export { defineTool } from './tools/defineTool.js';
@@ -62,25 +61,25 @@ export { MCP_PROVIDER, describeNeed, normalizeNeeds, toolsForNeed, toolsForNeeds
 export { OpenAIAdapter } from './adapters/OpenAIAdapter.js';
 export { extractJSON, safeParseJSON } from './utils/jsonExtractor.js';
 export { HistoryFormatter, historyFormatter, AgreementFormatter, agreementFormatter } from './formatters/index.js';
-export { ProactiveTrigger } from './server/proactive/ProactiveTrigger.js';
-export { PollRegistry, declaredPolls, } from './server/polls/PollKind.js';
-export { PollRunner } from './server/polls/PollRunner.js';
+export { ProactiveTrigger } from './platform/proactive/ProactiveTrigger.js';
+export { PollRegistry, declaredPolls, } from './platform/polls/PollKind.js';
+export { PollRunner } from './platform/polls/PollRunner.js';
 // the hand-rolled ZiggsPayClient / ZiggsConnectClient were deleted;
 // payment and connection tools now use @ziggs-ai/api-client's PaymentsClient /
 // ConnectionsClient, the same clients ziggs-mcp uses.
 // the hand-rolled ZiggsContextClient was deleted; context tools now
 // use the same @ziggs-ai/api-client clients as ziggs-mcp (GrantsClient /
 // ContextGrantsClient / ContextReadClient). Grant/reach types live there.
-// All agent tool bundles live under server/tools/ (tier1 = protocol grammar,
-// tier2 = opt-in HTTP capability bundles). Single home: server/tools/index.ts.
+// All agent tool bundles live under platform/tools/ (tier1 = protocol grammar,
+// tier2 = opt-in HTTP capability bundles). Single home: platform/tools/index.ts.
 export { 
 // Tier 1 — protocol grammar (framework-managed via taskTools).
 PROTOCOL_TOOLS, agreementProposeTool, agreementSubcontractTool, agreementRespondTool, agreementClaimTool, agreementCounterTool, agreementGetTool, agreementRevokeTool, agreementFulfillTool, taskCreateTool, taskSetResultTool, taskUpdatePlanStepTool, dispatchProtocolOp, 
 // Tier 2 — opt-in capability bundles (spread into `tools:`).
-PAYMENT_TOOLS, paymentBalanceTool, CONNECTION_TOOLS, connectionProxyTool, connectionListGrantsTool, requestConnectionTool, MCP_CONNECTION_TOOLS, mcpToolCallTool, mcpToolsListTool, DISCOVERY_TOOLS, agentSearchTool, agentGetTool, MARKETPLACE_TOOLS, marketplaceViewTool, CONTEXT_TOOLS, contextReadTool, contextDelegateTool, contextExpandReachTool, contextDiscoverGrantableTool, GRANTS_TOOLS, listGrantsTool, LINK_TOOLS, linkProposeTool, linkListTool, INTRODUCTION_TOOLS, introductionMintTool, introductionRedeemTool, introductionListTool, introductionRevokeTool, ARTIFACT_TOOLS, recordArtifactTool, CHAT_TOOLS, openConversationTool, } from './server/tools/index.js';
+PAYMENT_TOOLS, paymentBalanceTool, CONNECTION_TOOLS, connectionProxyTool, connectionListGrantsTool, requestConnectionTool, MCP_CONNECTION_TOOLS, mcpToolCallTool, mcpToolsListTool, DISCOVERY_TOOLS, agentSearchTool, agentGetTool, MARKETPLACE_TOOLS, marketplaceViewTool, CONTEXT_TOOLS, contextReadTool, contextDelegateTool, contextExpandReachTool, contextDiscoverGrantableTool, GRANTS_TOOLS, listGrantsTool, LINK_TOOLS, linkProposeTool, linkListTool, INTRODUCTION_TOOLS, introductionMintTool, introductionRedeemTool, introductionListTool, introductionRevokeTool, ARTIFACT_TOOLS, recordArtifactTool, CHAT_TOOLS, openConversationTool, } from './platform/tools/index.js';
 // The always-on toolset for the hosted Claude cognition (parity guard
 // reads this as part of the real SDK registry).
-export { CLAUDE_SDK_TOOLS } from './agent/claudeSdkTools.js';
+export { CLAUDE_SDK_TOOLS } from './brain/claudeSdkTools.js';
 export { PROTOCOL_TOOL_NAMES, PROTOCOL_TOOL_TO_OPERATION, mapProtocolToolToOperation, isProtocolToolName } from './tasks/protocolRegistry.js';
 export { InMemoryStore, FileMemoryStore } from './memory/MemoryStore.js';
 export { classifyIncomingEvent } from './context/classifyEnvelope.js';
@@ -91,5 +90,5 @@ export { MessagesClient, ArtifactsClient, AgentSearchClient, getBackendUrl,
 // self-hosted / non-default backend: consumers of agent-sdk alone
 // must be able to point the shared HTTP client without a direct api-client dep.
 configureApiClient, } from '@ziggs-ai/api-client';
-export { SeenMessages } from './server/SeenMessages.js';
+export { SeenMessages } from './platform/SeenMessages.js';
 export { runtimeLog, resetRuntimeLogLevelCache } from './shared/runtimeLog.js';