@zhin.js/agent 1.0.2 → 1.0.3

package/lib/authoring/disable-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disable-tool.js","sourceRoot":"","sources":["../../src/authoring/disable-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AAO5E,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,EAAE,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;WACtB,KAAK,IAAI,IAAI;WACZ,KAAyB,CAAC,mBAAmB,CAAC,KAAK,IAAI;WACxD,OAAQ,KAAyB,CAAC,IAAI,KAAK,QAAQ,CACvD,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,qBAAqB,CACnC,OAA+C;IAE/C,IAAI,CAAC,OAAO,EAAE,MAAM;QAAE,OAAO,SAAS,CAAC;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACjC,SAAS;QACX,CAAC;QACD,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1C,CAAC"}

package/lib/authoring/entries/connections.d.ts

@@ -0,0 +1,3 @@
+export { defineConnection } from '../define-connection.js';
+export type { DefineConnectionInput, ConnectionTransport } from '../define-connection.js';
+//# sourceMappingURL=connections.d.ts.map

package/lib/authoring/entries/connections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../../src/authoring/entries/connections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/lib/authoring/entries/connections.js

@@ -0,0 +1,2 @@
+export { defineConnection } from '../define-connection.js';
+//# sourceMappingURL=connections.js.map

package/lib/authoring/entries/connections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections.js","sourceRoot":"","sources":["../../../src/authoring/entries/connections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/lib/authoring/entries/evals.d.ts

@@ -0,0 +1,3 @@
+export { defineEval } from '../define-eval.js';
+export type { DefineEvalInput, AuthoringEvalContext } from '../define-eval.js';
+//# sourceMappingURL=evals.d.ts.map

package/lib/authoring/entries/evals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evals.d.ts","sourceRoot":"","sources":["../../../src/authoring/entries/evals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/authoring/entries/evals.js

@@ -0,0 +1,2 @@
+export { defineEval } from '../define-eval.js';
+//# sourceMappingURL=evals.js.map

package/lib/authoring/entries/evals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evals.js","sourceRoot":"","sources":["../../../src/authoring/entries/evals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/authoring/entries/hooks.d.ts

@@ -0,0 +1,3 @@
+export { defineHook } from '../define-hook.js';
+export type { DefineHookInput } from '../define-hook.js';
+//# sourceMappingURL=hooks.d.ts.map

package/lib/authoring/entries/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/authoring/entries/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/authoring/entries/hooks.js

@@ -0,0 +1,2 @@
+export { defineHook } from '../define-hook.js';
+//# sourceMappingURL=hooks.js.map

package/lib/authoring/entries/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/authoring/entries/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/authoring/entries/schedules.d.ts

@@ -0,0 +1,3 @@
+export { defineSchedule } from '../define-schedule.js';
+export type { DefineScheduleInput } from '../define-schedule.js';
+//# sourceMappingURL=schedules.d.ts.map

package/lib/authoring/entries/schedules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.d.ts","sourceRoot":"","sources":["../../../src/authoring/entries/schedules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/authoring/entries/schedules.js

@@ -0,0 +1,2 @@
+export { defineSchedule } from '../define-schedule.js';
+//# sourceMappingURL=schedules.js.map

package/lib/authoring/entries/schedules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.js","sourceRoot":"","sources":["../../../src/authoring/entries/schedules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/authoring/entries/skills.d.ts

@@ -0,0 +1,3 @@
+export { defineSkill } from '../define-skill.js';
+export type { DefineSkillInput } from '../define-skill.js';
+//# sourceMappingURL=skills.d.ts.map

package/lib/authoring/entries/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/authoring/entries/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/authoring/entries/skills.js

@@ -0,0 +1,2 @@
+export { defineSkill } from '../define-skill.js';
+//# sourceMappingURL=skills.js.map

package/lib/authoring/entries/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/authoring/entries/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/authoring/entries/tools.d.ts

@@ -0,0 +1,5 @@
+export { defineTool } from '../define-tool.js';
+export type { DefineToolInput, AuthoringToolContext } from '../define-tool.js';
+export { toolApprovalAlways, toolApprovalOnce, toolApprovalNever, always, once, never, } from '../tool-policy.js';
+export type { ToolApprovalPolicy, ToolToModelOutputFn } from '../tool-policy.js';
+//# sourceMappingURL=tools.d.ts.map

package/lib/authoring/entries/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/authoring/entries/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,MAAM,EACN,IAAI,EACJ,KAAK,GACN,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/authoring/entries/tools.js

@@ -0,0 +1,3 @@
+export { defineTool } from '../define-tool.js';
+export { toolApprovalAlways, toolApprovalOnce, toolApprovalNever, always, once, never, } from '../tool-policy.js';
+//# sourceMappingURL=tools.js.map

package/lib/authoring/entries/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/authoring/entries/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,MAAM,EACN,IAAI,EACJ,KAAK,GACN,MAAM,mBAAmB,CAAC"}

package/lib/authoring/index.d.ts

@@ -0,0 +1,25 @@
+export { defineAgent } from './define-agent.js';
+export type { DefineAgentInput } from './define-agent.js';
+export { disableTool, normalizeToolDenylist, isDisabledToolRef } from './disable-tool.js';
+export type { DisabledToolRef } from './disable-tool.js';
+export { defineTool } from './define-tool.js';
+export { toolApprovalAlways, toolApprovalOnce, toolApprovalNever, always, once, never, } from './tool-policy.js';
+export type { ToolApprovalPolicy, ToolToModelOutputFn } from './tool-policy.js';
+export type { DefineToolInput, AuthoringToolContext } from './define-tool.js';
+export { defineSkill } from './define-skill.js';
+export type { DefineSkillInput } from './define-skill.js';
+export { defineSchedule } from './define-schedule.js';
+export type { DefineScheduleInput } from './define-schedule.js';
+export { defineConnection } from './define-connection.js';
+export type { DefineConnectionInput, ConnectionTransport } from './define-connection.js';
+export { defineHook } from './define-hook.js';
+export type { DefineHookInput } from './define-hook.js';
+export { defineEval } from './define-eval.js';
+export type { DefineEvalInput, AuthoringEvalContext } from './define-eval.js';
+export { defineState } from './define-state.js';
+export type { DefineStateInput } from './define-state.js';
+export { defineDynamic } from './define-dynamic.js';
+export type { DefineDynamicInput } from './define-dynamic.js';
+export * from './types.js';
+export { namespaceAuthoringName, slotNameFromFile, slotNameFromDir, bridgeAuthoringTool, bridgeAuthoringToolToOrchestratorTool, bridgeAuthoringSkill, bridgeAuthoringConnection, bridgeAuthoringHook, } from './bridge.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/authoring/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/authoring/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,MAAM,EACN,IAAI,EACJ,KAAK,GACN,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAChF,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,qCAAqC,EACrC,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,aAAa,CAAC"}

package/lib/authoring/index.js

@@ -0,0 +1,14 @@
+export { defineAgent } from './define-agent.js';
+export { disableTool, normalizeToolDenylist, isDisabledToolRef } from './disable-tool.js';
+export { defineTool } from './define-tool.js';
+export { toolApprovalAlways, toolApprovalOnce, toolApprovalNever, always, once, never, } from './tool-policy.js';
+export { defineSkill } from './define-skill.js';
+export { defineSchedule } from './define-schedule.js';
+export { defineConnection } from './define-connection.js';
+export { defineHook } from './define-hook.js';
+export { defineEval } from './define-eval.js';
+export { defineState } from './define-state.js';
+export { defineDynamic } from './define-dynamic.js';
+export * from './types.js';
+export { namespaceAuthoringName, slotNameFromFile, slotNameFromDir, bridgeAuthoringTool, bridgeAuthoringToolToOrchestratorTool, bridgeAuthoringSkill, bridgeAuthoringConnection, bridgeAuthoringHook, } from './bridge.js';
+//# sourceMappingURL=index.js.map

package/lib/authoring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/authoring/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE1F,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,MAAM,EACN,IAAI,EACJ,KAAK,GACN,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,qCAAqC,EACrC,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,aAAa,CAAC"}

package/lib/authoring/tool-policy.d.ts

@@ -0,0 +1,3 @@
+export { toolApprovalAlways, toolApprovalOnce, toolApprovalNever, always, once, never, } from '@zhin.js/ai/tool-policy';
+export type { ToolApprovalMode, ToolApprovalPolicy, ToolToModelOutputInput, ToolToModelOutputFn, } from '@zhin.js/ai/tool-policy';
+//# sourceMappingURL=tool-policy.d.ts.map

package/lib/authoring/tool-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-policy.d.ts","sourceRoot":"","sources":["../../src/authoring/tool-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,MAAM,EACN,IAAI,EACJ,KAAK,GACN,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC"}

package/lib/authoring/tool-policy.js

@@ -0,0 +1,2 @@
+export { toolApprovalAlways, toolApprovalOnce, toolApprovalNever, always, once, never, } from '@zhin.js/ai/tool-policy';
+//# sourceMappingURL=tool-policy.js.map

package/lib/authoring/tool-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-policy.js","sourceRoot":"","sources":["../../src/authoring/tool-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,MAAM,EACN,IAAI,EACJ,KAAK,GACN,MAAM,yBAAyB,CAAC"}

package/lib/authoring/types.d.ts

@@ -0,0 +1,209 @@
+/**
+ * Authoring surface types — Eve-style filesystem-first agent definitions.
+ * Identity comes from the path; definitions do not carry name/id fields.
+ */
+import type { ToolParametersSchema } from '../orchestrator/types.js';
+import type { Message } from '@zhin.js/core';
+import type { ToolApprovalPolicy, ToolToModelOutputFn } from '@zhin.js/ai/tool-policy';
+export declare const AUTHORING_KIND: unique symbol;
+export type AuthoringKind = 'agent' | 'tool' | 'skill' | 'schedule' | 'connection' | 'hook' | 'eval' | 'state' | 'dynamic';
+export interface AuthoringMarker {
+    [AUTHORING_KIND]: AuthoringKind;
+}
+export interface AuthoringToolContext {
+    pluginName: string;
+    runtimeName: string;
+    filePath: string;
+}
+export interface AuthoringAgentDefinition extends AuthoringMarker {
+    [AUTHORING_KIND]: 'agent';
+    description?: string;
+    keywords?: string[];
+    tags?: string[];
+    role?: string;
+    contextMode?: 'fork' | 'fresh';
+    maxIterations?: number;
+    toolNames?: string[];
+    /** Tool names or {@link disableTool} sentinels to exclude from this agent. */
+    disallowedTools?: (string | import('./disable-tool.js').DisabledToolRef)[];
+    systemPrompt?: string;
+}
+export interface AuthoringToolDefinition<TInput = Record<string, unknown>> extends AuthoringMarker {
+    [AUTHORING_KIND]: 'tool';
+    description: string;
+    inputSchema: unknown;
+    execute: (input: TInput, ctx: AuthoringToolContext) => unknown | Promise<unknown>;
+    platforms?: string[];
+    scopes?: ('private' | 'group' | 'channel')[];
+    permissions?: string[];
+    tags?: string[];
+    keywords?: string[];
+    hidden?: boolean;
+    /** `always` | `once` | `never` or custom predicate — stacks with ExecPolicy (ADR 0039 P1). */
+    approval?: ToolApprovalPolicy;
+    /** Shapes string sent to the model after execute (ADR 0039 P1). */
+    toModelOutput?: ToolToModelOutputFn<TInput>;
+}
+export interface AuthoringSkillDefinition extends AuthoringMarker {
+    [AUTHORING_KIND]: 'skill';
+    description: string;
+    content: string;
+    keywords?: string[];
+    tags?: string[];
+    toolNames?: string[];
+    always?: boolean;
+    platforms?: string[];
+}
+export interface AuthoringScheduleDefinition extends AuthoringMarker {
+    [AUTHORING_KIND]: 'schedule';
+    cron: string;
+    description?: string;
+    execute: () => void | Promise<void>;
+}
+export type ConnectionTransport = 'stdio' | 'streamable-http' | 'sse';
+export interface AuthoringConnectionDefinition extends AuthoringMarker {
+    [AUTHORING_KIND]: 'connection';
+    description: string;
+    transport: ConnectionTransport;
+    configSchema: unknown;
+    url?: string;
+    command?: string;
+    args?: string[];
+    headers?: Record<string, string>;
+    buildEntry: (config: Record<string, unknown>) => {
+        url?: string;
+        command?: string;
+        args?: string[];
+        env?: Record<string, string>;
+        headers?: Record<string, string>;
+    };
+}
+export interface AuthoringHookDefinition extends AuthoringMarker {
+    [AUTHORING_KIND]: 'hook';
+    event: string;
+    handler: (event: import('../orchestrator/types.js').AIHookEvent) => void | Promise<void>;
+}
+export interface AuthoringEvalContext {
+    send: (message: string) => Promise<void>;
+    get reply(): string;
+    succeeded: () => void;
+    calledTool: (name: string) => {
+        soft: () => void;
+    };
+}
+export interface AuthoringEvalDefinition extends AuthoringMarker {
+    [AUTHORING_KIND]: 'eval';
+    description?: string;
+    test: (t: AuthoringEvalContext) => void | Promise<void>;
+}
+export interface AuthoringStateDefinition<T = unknown> extends AuthoringMarker {
+    [AUTHORING_KIND]: 'state';
+    /** Defaults to state file slot name when discovered from agent/state/*.ts */
+    name?: string;
+    initial?: T | (() => T);
+}
+export interface DynamicResolveContext {
+    sessionId: string;
+    userId: string;
+    adapter: string;
+    commMessage: Message;
+    agentId?: string;
+}
+export interface DynamicResolveResult {
+    additionalInstructions?: string;
+    allowedToolNames?: string[];
+    deniedToolNames?: string[];
+}
+export interface AuthoringDynamicDefinition extends AuthoringMarker {
+    [AUTHORING_KIND]: 'dynamic';
+    resolve: (ctx: DynamicResolveContext) => DynamicResolveResult | void | Promise<DynamicResolveResult | void>;
+}
+export interface DiscoveredAuthoringState {
+    runtimeName: string;
+    slotName: string;
+    pluginName: string;
+    filePath: string;
+    definition: AuthoringStateDefinition;
+}
+export interface DiscoveredAuthoringDynamic {
+    pluginName: string;
+    filePath: string;
+    definition: AuthoringDynamicDefinition;
+}
+export interface DiscoveredAuthoringTool {
+    runtimeName: string;
+    slotName: string;
+    pluginName: string;
+    filePath: string;
+    definition: AuthoringToolDefinition;
+}
+export interface DiscoveredAuthoringSkill {
+    runtimeName: string;
+    slotName: string;
+    pluginName: string;
+    filePath: string;
+    definition: AuthoringSkillDefinition;
+}
+export interface DiscoveredAuthoringSchedule {
+    runtimeName: string;
+    slotName: string;
+    pluginName: string;
+    filePath: string;
+    definition: AuthoringScheduleDefinition;
+}
+export interface DiscoveredAuthoringConnection {
+    runtimeName: string;
+    slotName: string;
+    pluginName: string;
+    filePath: string;
+    definition: AuthoringConnectionDefinition;
+}
+export interface DiscoveredAuthoringHook {
+    runtimeName: string;
+    slotName: string;
+    pluginName: string;
+    filePath: string;
+    definition: AuthoringHookDefinition;
+}
+export interface DiscoveredAuthoringEval {
+    runtimeName: string;
+    slotName: string;
+    pluginName: string;
+    filePath: string;
+    definition: AuthoringEvalDefinition;
+}
+export interface DiscoveredPluginAgentSurface {
+    pluginName: string;
+    agentDir: string;
+    agentDefinition?: AuthoringAgentDefinition;
+    instructionsPath?: string;
+    instructionsBody?: string;
+    tools: DiscoveredAuthoringTool[];
+    skills: DiscoveredAuthoringSkill[];
+    schedules: DiscoveredAuthoringSchedule[];
+    connections: DiscoveredAuthoringConnection[];
+    hooks: DiscoveredAuthoringHook[];
+    states: DiscoveredAuthoringState[];
+    dynamic?: DiscoveredAuthoringDynamic;
+    evals: DiscoveredAuthoringEval[];
+    subagents: DiscoveredPluginAgentSurface[];
+}
+export declare function isAuthoringDefinition(value: unknown, kind: AuthoringKind): boolean;
+export type BridgedToolExecute = (args: Record<string, unknown>, message?: Message) => unknown | Promise<unknown>;
+export interface BridgedToolFromAuthoring {
+    name: string;
+    description: string;
+    parameters: ToolParametersSchema;
+    execute: BridgedToolExecute;
+    platforms?: string[];
+    scopes?: ('private' | 'group' | 'channel')[];
+    permissions?: string[];
+    tags?: string[];
+    keywords?: string[];
+    hidden?: boolean;
+    source: string;
+    filePath: string;
+    approval?: ToolApprovalPolicy;
+    toModelOutput?: ToolToModelOutputFn;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/authoring/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/authoring/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEvF,eAAO,MAAM,cAAc,eAAoC,CAAC;AAEhE,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,MAAM,GACN,OAAO,GACP,UAAU,GACV,YAAY,GACZ,MAAM,GACN,MAAM,GACN,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,CAAC,MAAM,GAAG,OAAO,mBAAmB,EAAE,eAAe,CAAC,EAAE,CAAC;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,SAAQ,eAAe;IAChG,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,mEAAmE;IACnE,aAAa,CAAC,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,2BAA4B,SAAQ,eAAe;IAClE,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,iBAAiB,GAAG,KAAK,CAAC;AAEtE,MAAM,WAAW,6BAA8B,SAAQ,eAAe;IACpE,CAAC,cAAc,CAAC,EAAE,YAAY,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK;QAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;CACH;AAED,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,0BAA0B,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1F;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,KAAK,IAAI,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;CACpD;AAED,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,eAAe;IAC5E,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC1B,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA2B,SAAQ,eAAe;IACjE,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC;IAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,oBAAoB,GAAG,IAAI,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;CAC7G;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,wBAAwB,CAAC;CACtC;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,0BAA0B,CAAC;CACxC;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,uBAAuB,CAAC;CACrC;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,wBAAwB,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,2BAA2B,CAAC;CACzC;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,6BAA6B,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,uBAAuB,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,uBAAuB,CAAC;CACrC;AAED,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,wBAAwB,CAAC;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC,SAAS,EAAE,2BAA2B,EAAE,CAAC;IACzC,WAAW,EAAE,6BAA6B,EAAE,CAAC;IAC7C,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE,0BAA0B,CAAC;IACrC,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC,SAAS,EAAE,4BAA4B,EAAE,CAAC;CAC3C;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAGlF;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAElH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,oBAAoB,CAAC;IACjC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC"}

package/lib/authoring/types.js

@@ -0,0 +1,10 @@
+/**
+ * Authoring surface types — Eve-style filesystem-first agent definitions.
+ * Identity comes from the path; definitions do not carry name/id fields.
+ */
+export const AUTHORING_KIND = Symbol.for('zhin.authoring.kind');
+export function isAuthoringDefinition(value, kind) {
+    return typeof value === 'object' && value !== null
+        && value[AUTHORING_KIND] === kind;
+}
+//# sourceMappingURL=types.js.map

package/lib/authoring/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/authoring/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;AAwNhE,MAAM,UAAU,qBAAqB,CAAC,KAAc,EAAE,IAAmB;IACvE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;WAC5C,KAAyB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;AAC3D,CAAC"}

package/lib/authoring/zod-schema.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Zod object schema → ToolParametersSchema for authoring tools.
+ */
+import type { ToolParametersSchema } from '../orchestrator/types.js';
+export declare function zodObjectToParameters(schema: unknown): ToolParametersSchema;
+export declare function parseWithZodSchema<T>(schema: unknown, args: Record<string, unknown>): {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function parseConfigWithZodSchema(schema: unknown, config: unknown): {
+    ok: true;
+    data: Record<string, unknown>;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=zod-schema.d.ts.map

package/lib/authoring/zod-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-schema.d.ts","sourceRoot":"","sources":["../../src/authoring/zod-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAoCrE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,oBAAoB,CAqB3E;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAW1I;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAErJ"}

package/lib/authoring/zod-schema.js

@@ -0,0 +1,79 @@
+/**
+ * Zod object schema → ToolParametersSchema for authoring tools.
+ */
+function zodFieldToJsonSchema(z) {
+    const zod = z;
+    if (!zod || !zod._def)
+        return { type: 'string' };
+    const def = zod._def;
+    const typeName = def.typeName;
+    if (typeName === 'ZodOptional' || typeName === 'ZodDefault') {
+        const inner = def.innerType ?? def.type;
+        return zodFieldToJsonSchema(inner);
+    }
+    if (typeName === 'ZodString') {
+        const out = { type: 'string' };
+        if (def.description)
+            out.description = def.description;
+        return out;
+    }
+    if (typeName === 'ZodNumber') {
+        const out = { type: 'number' };
+        if (def.description)
+            out.description = def.description;
+        return out;
+    }
+    if (typeName === 'ZodBoolean') {
+        const out = { type: 'boolean' };
+        if (def.description)
+            out.description = def.description;
+        return out;
+    }
+    if (typeName === 'ZodEnum') {
+        return { type: 'string', enum: def.values };
+    }
+    if (typeName === 'ZodArray') {
+        return { type: 'array', items: zodFieldToJsonSchema(def.type ?? def.element) };
+    }
+    return { type: 'string' };
+}
+export function zodObjectToParameters(schema) {
+    const result = {
+        type: 'object',
+        properties: {},
+        required: [],
+    };
+    const s = schema;
+    if (!s?.shape)
+        return result;
+    const required = [];
+    for (const [key, value] of Object.entries(s.shape)) {
+        const zodValue = value;
+        const props = result.properties ?? {};
+        props[key] = zodFieldToJsonSchema(zodValue);
+        result.properties = props;
+        const typeName = zodValue?._def?.typeName;
+        if (typeName !== 'ZodOptional' && typeName !== 'ZodDefault') {
+            required.push(key);
+        }
+    }
+    if (required.length > 0)
+        result.required = required;
+    return result;
+}
+export function parseWithZodSchema(schema, args) {
+    const s = schema;
+    if (!s?.safeParse) {
+        return { ok: true, data: args };
+    }
+    const parsed = s.safeParse(args);
+    if (!parsed.success) {
+        const msg = parsed.error?.errors?.map((e) => `${e.path?.join('.') ?? 'root'}: ${e.message ?? 'invalid'}`).join('; ') ?? 'Invalid arguments';
+        return { ok: false, error: msg };
+    }
+    return { ok: true, data: parsed.data };
+}
+export function parseConfigWithZodSchema(schema, config) {
+    return parseWithZodSchema(schema, (config ?? {}));
+}
+//# sourceMappingURL=zod-schema.js.map

package/lib/authoring/zod-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-schema.js","sourceRoot":"","sources":["../../src/authoring/zod-schema.ts"],"names":[],"mappings":"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"}

package/lib/collaboration/ask-user-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ask-user-bridge.d.ts","sourceRoot":"","sources":["../../src/collaboration/ask-user-bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAO7C,4EAA4E;AAC5E,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,OAAO,EACpB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAmBpB;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAuBtF;AAED,wBAAsB,+BAA+B,CACnD,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAUf"}
+{"version":3,"file":"ask-user-bridge.d.ts","sourceRoot":"","sources":["../../src/collaboration/ask-user-bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAO7C,4EAA4E;AAC5E,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,OAAO,EACpB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAmBpB;AAiBD,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAuBtF;AAED,wBAAsB,+BAA+B,CACnD,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/lib/collaboration/ask-user-bridge.js

@@ -14,14 +14,28 @@ export function shouldBlockDelegationAskUser(commMessage, question, questionType
     const q = question.trim();
     if (questionType !== 'confirm')
         return undefined;
-    if (/授权|authorize|是否.*(调用|使用|委派|派遣)|allow.*(researcher|executor|delegate|agent)/i.test(q)) {
+    if (looksLikeDelegationAuthorization(q)) {
         return 'Error: In group collaboration, do not ask_owner to authorize delegation. Use orchestration_add_task (internal_room) or spawn_task with the peer endpoint.';
     }
-    if (/Researcher|Evaluator|Executor|Reviewer/i.test(q) && /是否|authorize|授权|调用/i.test(q)) {
+    if (mentionsPipelineRole(q) && containsAny(q.toLowerCase(), ['是否', 'authorize', '授权', '调用'])) {
         return 'Error: In group collaboration, dispatch peers via OrchestrationKernel (internal_room task) — do not ask_owner for role authorization.';
     }
     return undefined;
 }
+function looksLikeDelegationAuthorization(text) {
+    const lower = text.toLowerCase();
+    if (text.includes('授权') || lower.includes('authorize'))
+        return true;
+    if (text.includes('是否') && containsAny(text, ['调用', '使用', '委派', '派遣']))
+        return true;
+    return lower.includes('allow') && containsAny(lower, ['researcher', 'executor', 'delegate', 'agent']);
+}
+function mentionsPipelineRole(text) {
+    return containsAny(text.toLowerCase(), ['researcher', 'evaluator', 'executor', 'reviewer']);
+}
+function containsAny(text, needles) {
+    return needles.some((needle) => text.includes(needle));
+}
 export function buildGroupAskUserFollowUp(commMessage, answer) {
     const scope = commMessage.$channel?.type;
     if (scope !== 'group' && scope !== 'channel')

package/lib/collaboration/ask-user-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask-user-bridge.js","sourceRoot":"","sources":["../../src/collaboration/ask-user-bridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ask-user-bridge.js","sourceRoot":"","sources":["../../src/collaboration/ask-user-bridge.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EACL,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,4EAA4E;AAC5E,MAAM,UAAU,4BAA4B,CAC1C,WAAoB,EACpB,QAAgB,EAChB,YAAoB;IAEpB,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC;IACzC,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC/D,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC;IACzC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,IAAI,GAAG,mBAAmB,CAC9B,MAAM,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC,EAClC,OAAO,CACR,CAAC;IACF,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACvD,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,gCAAgC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,OAAO,2JAA2J,CAAC;IACrK,CAAC;IACD,IAAI,oBAAoB,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;QAC7F,OAAO,uIAAuI,CAAC;IACjJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gCAAgC,CAAC,IAAY;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IACpE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpF,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AACxG,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,OAAO,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,OAA0B;IAC3D,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,WAAoB,EAAE,MAAc;IAC5E,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC;IACzC,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAC5D,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC;IACzC,IAAI,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC;IAC5B,MAAM,IAAI,GAAG,mBAAmB,CAC9B,MAAM,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC,EAClC,OAAO,CACR,CAAC;IACF,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IAEpD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;IACtF,MAAM,MAAM,GAAG,IAAI,EAAE,UAAU,IAAI,gBAAgB,CAAC;IACpD,MAAM,SAAS,GAAG,IAAI,EAAE,YAAY,IAAI,IAAI,EAAE,OAAO,IAAI,WAAW,CAAC;IAErE,OAAO;QACL,MAAM;QACN,EAAE;QACF,kEAAkE,OAAO,GAAG;QAC5E,wEAAwE,MAAM,mCAAmC,SAAS,IAAI;QAC9H,sIAAsI;QACtI,yDAAyD;KAC1D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,WAAoB,EACpB,MAAc;IAEd,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC;IACzC,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO;IACrD,MAAM,6BAA6B,CAAC;QAClC,OAAO,EAAE,WAAW;QACpB,IAAI,EAAE,wBAAwB,CAAC,WAAW,CAAC;QAC3C,KAAK,EAAE,GAAG;QACV,QAAQ,EAAE,WAAW;QACrB,MAAM,EAAE,MAAM;KACf,CAAC,CAAC;AACL,CAAC"}

package/lib/collaboration/inbound-turn-execute.js

@@ -45,14 +45,14 @@ export async function executeInboundAgentTurn(input) {
             };
         }
         try {
-            elements = await zhinAgent.process(fullContent, commMessage, externalTools, onChunk);
+            elements = (await zhinAgent.process(fullContent, commMessage, externalTools, onChunk)) ?? [];
         }
         catch {
             const parts = [];
             if (aiContent)
                 parts.push({ type: 'text', text: aiContent });
             parts.push(...mediaParts);
-            elements = await zhinAgent.processMultimodal(parts, commMessage, onChunk);
+            elements = (await zhinAgent.processMultimodal(parts, commMessage, onChunk)) ?? [];
         }
     }
     else if (mediaParts.length > 0) {
@@ -60,10 +60,10 @@ export async function executeInboundAgentTurn(input) {
         if (aiContent)
             parts.push({ type: 'text', text: aiContent });
         parts.push(...mediaParts);
-        elements = await zhinAgent.processMultimodal(parts, commMessage, onChunk);
+        elements = (await zhinAgent.processMultimodal(parts, commMessage, onChunk)) ?? [];
     }
     else {
-        elements = await zhinAgent.process(aiContent, commMessage, externalTools, onChunk);
+        elements = (await zhinAgent.process(aiContent, commMessage, externalTools, onChunk)) ?? [];
     }
     if (cell) {
         elements = stripCellToolJsonFromOutputElements(elements);