@zpi-dev/agent-sdk 0.1.60 → 0.1.61

package/dist/host.js

@@ -4,12 +4,10 @@ import {
   SettingsManager,
   createAgentSession,
   query
-} from "./chunk-4WFFCN2C.js";
-import "./chunk-AR5RMMMN.js";
-import "./chunk-RAZL7ZAW.js";
-import "./chunk-YBW5XDR7.js";
+} from "./chunk-YPFTXFZL.js";
+import "./chunk-GPIEWH3K.js";
 
-// packages/agent-sdk/src/query-result.ts
+// src/query-result.ts
 async function queryResult(params, observe) {
   let result;
   for await (const message of query(params)) {

package/dist/host.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/query-result.ts"],"sourcesContent":["import { type QueryParams, query } from \"./query.ts\";\nimport type { SDKMessage, SDKResultMessage } from \"./types.ts\";\n\n/** Consume a query and return its successful terminal result. */\nexport async function queryResult(\n  params: QueryParams,\n  observe?: (message: SDKMessage) => void,\n): Promise<Extract<SDKResultMessage, { subtype: \"success\" }>> {\n  let result: SDKResultMessage | undefined;\n  for await (const message of query(params)) {\n    observe?.(message);\n    if (message.type === \"result\") result = message;\n  }\n  if (!result) throw new Error(\"Agent SDK returned no result\");\n  if (result.subtype !== \"success\")\n    throw Object.assign(new Error(result.errors.join(\"\\n\")), { sdkResult: result });\n  return result;\n}\n\nexport function nativeStopReason(reason: string | null): string {\n  return reason === \"end_turn\"\n    ? \"stop\"\n    : reason === \"tool_use\"\n      ? \"toolUse\"\n      : reason === \"max_tokens\"\n        ? \"length\"\n        : (reason ?? \"error\");\n}\n"],"mappings":";;;;;;;;;;;;AAIA,eAAsB,YACpB,QACA,SAC4D;AAC5D,MAAI;AACJ,mBAAiB,WAAW,MAAM,MAAM,GAAG;AACzC,cAAU,OAAO;AACjB,QAAI,QAAQ,SAAS,SAAU,UAAS;AAAA,EAC1C;AACA,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,8BAA8B;AAC3D,MAAI,OAAO,YAAY;AACrB,UAAM,OAAO,OAAO,IAAI,MAAM,OAAO,OAAO,KAAK,IAAI,CAAC,GAAG,EAAE,WAAW,OAAO,CAAC;AAChF,SAAO;AACT;AAEO,SAAS,iBAAiB,QAA+B;AAC9D,SAAO,WAAW,aACd,SACA,WAAW,aACT,YACA,WAAW,eACT,WACC,UAAU;AACrB;","names":[]}
+{"version":3,"sources":["../src/query-result.ts"],"sourcesContent":["import { type QueryParams, query } from \"./query.ts\";\nimport type { SDKMessage, SDKResultMessage } from \"./types.ts\";\n\n/** Consume a query and return its successful terminal result. */\nexport async function queryResult(\n  params: QueryParams,\n  observe?: (message: SDKMessage) => void,\n): Promise<Extract<SDKResultMessage, { subtype: \"success\" }>> {\n  let result: SDKResultMessage | undefined;\n  for await (const message of query(params)) {\n    observe?.(message);\n    if (message.type === \"result\") result = message;\n  }\n  if (!result) throw new Error(\"Agent SDK returned no result\");\n  if (result.subtype !== \"success\")\n    throw Object.assign(new Error(result.errors.join(\"\\n\")), { sdkResult: result });\n  return result;\n}\n\nexport function nativeStopReason(reason: string | null): string {\n  return reason === \"end_turn\"\n    ? \"stop\"\n    : reason === \"tool_use\"\n      ? \"toolUse\"\n      : reason === \"max_tokens\"\n        ? \"length\"\n        : (reason ?? \"error\");\n}\n"],"mappings":";;;;;;;;;;AAIA,eAAsB,YACpB,QACA,SAC4D;AAC5D,MAAI;AACJ,mBAAiB,WAAW,MAAM,MAAM,GAAG;AACzC,cAAU,OAAO;AACjB,QAAI,QAAQ,SAAS,SAAU,UAAS;AAAA,EAC1C;AACA,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,8BAA8B;AAC3D,MAAI,OAAO,YAAY;AACrB,UAAM,OAAO,OAAO,IAAI,MAAM,OAAO,OAAO,KAAK,IAAI,CAAC,GAAG,EAAE,WAAW,OAAO,CAAC;AAChF,SAAO;AACT;AAEO,SAAS,iBAAiB,QAA+B;AAC9D,SAAO,WAAW,aACd,SACA,WAAW,aACT,YACA,WAAW,eACT,WACC,UAAU;AACrB;","names":[]}

package/dist/index.js

@@ -8,10 +8,8 @@ import {
   query,
   renameSession,
   tagSession
-} from "./chunk-4WFFCN2C.js";
-import "./chunk-AR5RMMMN.js";
-import "./chunk-RAZL7ZAW.js";
-import "./chunk-YBW5XDR7.js";
+} from "./chunk-YPFTXFZL.js";
+import "./chunk-GPIEWH3K.js";
 export {
   ModelRuntime,
   forkSession,

package/dist/{src-7WDJXP5P.js → src-GYA4LFM7.js}

@@ -60,9 +60,7 @@ import {
   usesChatGPTAuth,
   validateReasoningConfig,
   validateThinkingMap
-} from "./chunk-AR5RMMMN.js";
-import "./chunk-RAZL7ZAW.js";
-import "./chunk-YBW5XDR7.js";
+} from "./chunk-GPIEWH3K.js";
 export {
   AssistantMessageEventStream,
   DEFAULT_MAX_AGENT_RETRY_DELAY_MS,
@@ -125,4 +123,4 @@ export {
   validateReasoningConfig,
   validateThinkingMap
 };
-//# sourceMappingURL=src-7WDJXP5P.js.map
+//# sourceMappingURL=src-GYA4LFM7.js.map

package/dist/types/ai/src/types.d.ts

@@ -83,7 +83,7 @@ export interface AnthropicMessagesCompat {
     supportsStrictTools?: boolean;
     /** Whether the exact model transport supports effort-only system messages and thinking binding controls. Default: false. */
     supportsMidConvoEffort?: boolean;
-    /** Whether the exact model accepts system-role messages inside the conversation. When false, later system messages are folded into the top-level system prompt. Default: false. */
+    /** Whether the exact model accepts system-role messages inside the conversation. When false, updates remain in place as user messages. Default: false. */
     supportsMidConvoSystemMessages?: boolean;
     /** Whether the exact model accepts mid-conversation `tool_addition` and `tool_removal` blocks. Requires `supportsMidConvoSystemMessages`. Default: false. */
     supportsMidConvoToolChanges?: boolean;
@@ -176,6 +176,7 @@ export interface SystemMessage {
     role: "system";
     content: string | TextContent[];
     timestamp: number;
+    /** Named context patches: a string replaces the entire block; null withdraws every earlier version. */
     sections?: Record<string, string | null>;
     toolsAdded?: Tool[];
     toolsRemoved?: {

package/dist/types/ai/src/utils/text.d.ts

@@ -1,9 +1,5 @@
 import type { SystemMessage } from "../types.js";
-/** Render a system message as a complete prompt: its content followed by its sections. */
-export declare function getSystemMessageText(message: SystemMessage): string;
 /**
- * Render a later system message for APIs that accept system messages mid-conversation.
- * Section changes are framed by name so the model can relate them to the leading prompt.
- * This framing is request-time only and may change between versions.
+ * Shared wire representation of named context changes, regardless of provider role.
  */
 export declare function renderSystemMessageUpdate(message: SystemMessage): string;

package/dist/types/ai/src/utils/transcript.d.ts

@@ -20,19 +20,6 @@ export type TranscriptMessages = readonly {
 }[];
 /** Return the leading system message, if the transcript starts with one. */
 export declare function getInitialSystemMessage(messages: TranscriptMessages): SystemMessage | undefined;
-/**
- * Replay every system message into one leading system message holding the current
- * prompt and tools. Later `content` is appended to the base prompt, `sections` are
- * patched by name, and tools are resolved with {@link getCurrentTools}.
- */
-export declare function getCurrentSystemMessage(messages: TranscriptMessages): SystemMessage | undefined;
-/**
- * Rebuild the transcript for APIs without mid-conversation system messages: the replayed
- * system message leads, and every later system message is dropped.
- */
-export declare function collapseSystemMessages(context: TranscriptContext): TranscriptContext;
-/** Keep later system messages in place when the model accepts them; otherwise collapse them. */
-export declare function resolveTranscript(context: TranscriptContext, supportsMidConvoSystemMessages: boolean | undefined): TranscriptContext;
 export declare function getDeclaredTools(messages: TranscriptMessages): Tool[];
 /**
  * Whether a tool name was declared twice with different definitions. Transports that

package/dist/types/coding-agent/src/core/agent-session.d.ts

@@ -9,6 +9,7 @@ import type { LoadedSkill, SkillList } from "./resources.js";
 import type { SessionEntry, SessionManager } from "./session-manager.js";
 import type { ContextUsage } from "./session-state.js";
 import { SettingsManager } from "./settings-manager.js";
+import type { SystemContext } from "./system-prompt.js";
 import type { ResourceDiagnostic, ResourceLoader } from "./types.js";
 export interface InputContext {
     images?: ImageContent[];
@@ -88,7 +89,7 @@ export declare class AgentSession {
     get modelPerformance(): ModelPerformance;
     constructor(model: Model, runtime: ModelRuntime, manager: SessionManager, allTools: AgentTool[], activeTools: AgentTool[], systemPrompt: string, thinkingLevel: ThinkingLevel, resources?: {
         loader: ResourceLoader;
-        buildPrompt: () => string;
+        buildContext: () => SystemContext;
         settingsManager?: SettingsManager;
     }, performanceTotals?: ModelPerformanceTotals, extensions?: {
         modelRequestOptions?: () => SimpleStreamOptions;
@@ -122,7 +123,7 @@ export declare class AgentSession {
     }[];
     submit(text: string): Promise<void>;
     executeInput(input: ParsedInput, context?: InputContext): Promise<void>;
-    private syncSection;
+    private syncContext;
     private refreshInstructions;
     private compactionBoundary;
     private estimateTokens;

package/dist/types/coding-agent/src/core/dynamic-context.d.ts

@@ -0,0 +1,3 @@
+import type { Message, SystemMessage } from "../../../ai/src/index.js";
+/** Full desired SDK state in, only changed blocks out. Foreign system state is never withdrawn. */
+export declare function contextUpdate(messages: readonly Message[], current: Readonly<Record<string, string>>): SystemMessage | undefined;

package/dist/types/coding-agent/src/core/resources.d.ts

@@ -48,4 +48,4 @@ export declare class FileResourceLoader implements ResourceLoader {
     loadSkill(name: string): Promise<LoadedSkill>;
     getDiagnostics(): ResourceDiagnostic[];
 }
-export declare function formatSkillsForPrompt(skills: SkillMetadata[], tool?: "read" | "bash"): string;
+export declare function formatSkillsForPrompt(skills: SkillMetadata[], tool?: "read" | "bash" | "Read" | "Bash" | "Skill"): string;

package/dist/types/coding-agent/src/core/sdk.d.ts

@@ -12,8 +12,6 @@ import { type PromptTemplate } from "./system-prompt.js";
 import type { ResourceLoader } from "./types.js";
 export interface SystemPromptContext {
     tools: readonly AgentTool[];
-    pluginInstructions: readonly string[];
-    resourceLoader: ResourceLoader;
 }
 export interface CreateAgentSessionOptions extends SessionContributions {
     /** Build tool definitions and selection once the shared resource catalog is loaded. */
@@ -23,7 +21,7 @@ export interface CreateAgentSessionOptions extends SessionContributions {
         manual: boolean;
         instructions: string;
     }, signal?: AbortSignal) => Promise<void>;
-    /** Explicit complete prompt, evaluated again after resource refresh. */
+    /** Base instructions only. SDK resources and plugin context remain independently managed. */
     systemPrompt?: string | ((context: SystemPromptContext) => string);
     /** Host policy checked at each foreground model request, including continuation requests. */
     beforeModelRequest?: (model: Model, context: Context) => void;

package/dist/types/coding-agent/src/core/session-manager.d.ts

@@ -45,6 +45,7 @@ export type SessionEntry = EntryBase & ({
     };
     usage?: Usage;
     systemMessage?: SystemMessage;
+    contextMessage?: SystemMessage;
 });
 export interface SessionContext {
     messages: Message[];

package/dist/types/coding-agent/src/core/system-prompt.d.ts

@@ -13,7 +13,11 @@ export declare function renderTemplate(text: string, context: {
     project_name: string;
     platform: string;
 }): string;
-export declare function buildSystemPrompt(options: {
+export interface SystemContext {
+    base: string;
+    sections: Record<string, string>;
+}
+export declare function buildSystemContext(options: {
     cwd: string;
     projectName?: string;
     platform?: string;
@@ -22,4 +26,7 @@ export declare function buildSystemPrompt(options: {
     loader?: ResourceLoader;
     /** Literal instructions appended after resources, before the skill catalog and working directory. */
     customInstructions?: readonly string[];
-}): string;
+    baseInstructions?: string;
+}): SystemContext;
+/** Human-readable preview; model requests use the independently managed blocks. */
+export declare function buildSystemPrompt(options: Parameters<typeof buildSystemContext>[0]): string;

package/dist/types/coding-agent/src/plugins/assembly.d.ts

@@ -23,8 +23,7 @@ export declare function assembleSession(options: SessionContributions & {
     activeTools: AgentTool<TSchema, import("../../../ai/src/index.js").JsonValue | undefined>[];
     commands: PluginCommand[];
     skills: import("./types.js").PluginSkill[];
-    instructions: string[];
-    getInstructions: () => any[];
+    getContextSections: () => Record<string, string>;
     hooks: {
         event: import("./hooks.js").HookEvent;
         matcher?: string;

package/dist/types/coding-agent/src/plugins/types.d.ts

@@ -34,7 +34,8 @@ export interface SessionPlugin extends PluginSnapshot {
     tools?: readonly ToolDefinition<TSchema, unknown>[];
     /** Explicitly replace an existing built-in; collisions are rejected during assembly. */
     toolOverrides?: readonly ToolDefinition<TSchema, unknown>[];
-    /** Pure synchronous context reader, evaluated for previews and after prompt hooks/resource refresh. */
-    contextInstructions?: () => readonly string[];
+    /** Pure current-state reader. Local block names are scoped to this plugin by the SDK.
+     * Omitted/empty blocks withdraw prior versions; no plugin-owned diffing or history writes. */
+    contextInstructions?: () => Readonly<Record<string, string>>;
     hooks?: readonly HookRegistration[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zpi-dev/agent-sdk",
-  "version": "0.1.60",
+  "version": "0.1.61",
   "type": "module",
   "description": "TypeScript Agent SDK for ZPI with a Claude-compatible public API",
   "exports": {
@@ -36,10 +36,10 @@
     "@anthropic-ai/sdk": "0.124.0"
   },
   "devDependencies": {
-    "@zpi-dev/ai": "0.1.60",
-    "@zpi-dev/agent": "0.1.60",
-    "@zpi-dev/coding-agent": "0.1.60",
-    "@zpi-dev/plugin-compat": "0.1.60",
+    "@zpi-dev/ai": "0.1.61",
+    "@zpi-dev/agent": "0.1.61",
+    "@zpi-dev/coding-agent": "0.1.61",
+    "@zpi-dev/plugin-compat": "0.1.61",
     "yaml": "2.9.1"
   },
   "repository": {