@zhin.js/agent 1.0.1 → 1.0.3

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":"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"}

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/builtin/analyze-media-tool.d.ts

@@ -3,7 +3,7 @@ import { BuiltinBaseTool } from './builtin-base-tool.js';
 export declare const ANALYZE_MEDIA_PARAMETERS: ToolParametersSchema;
 export declare class AnalyzeMediaBuiltinTool extends BuiltinBaseTool {
     readonly name = "analyze_media";
-    readonly description = "\u5206\u6790\u672C\u5730\u56FE\u7247\u3001\u97F3\u9891\u6216\u89C6\u9891\u6587\u4EF6\uFF0C\u8FD4\u56DE\u53EF\u8BFB\u6458\u8981\uFF08\u8F6C\u5199/\u5C3A\u5BF8/\u683C\u5F0F\uFF09\uFF1B\u4E0D\u8981\u5BF9\u5A92\u4F53\u6587\u4EF6\u4F7F\u7528 read_file\u3002";
+    readonly description = "Analyze a local image, audio, or video file and return a readable summary (transcript/dimensions/format). Do not use read_file for media files.";
     readonly parameters: ToolParametersSchema<Record<string, any>>;
     readonly kind = "file";
     constructor();

package/lib/builtin/analyze-media-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-media-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/analyze-media-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIrF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAgBzD,eAAO,MAAM,wBAAwB,EAAE,oBAMtC,CAAC;AAEF,qBAAa,uBAAwB,SAAQ,eAAe;IAC1D,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,kQACqC;IACzD,QAAQ,CAAC,UAAU,4CAA4B;IAC/C,QAAQ,CAAC,IAAI,UAAU;;IAQjB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;CA+DrF;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}
+{"version":3,"file":"analyze-media-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/analyze-media-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIrF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAgBzD,eAAO,MAAM,wBAAwB,EAAE,oBAMtC,CAAC;AAEF,qBAAa,uBAAwB,SAAQ,eAAe;IAC1D,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,qJACgI;IACpJ,QAAQ,CAAC,UAAU,4CAA4B;IAC/C,QAAQ,CAAC,IAAI,UAAU;;IAQjB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;CA+DrF;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/lib/builtin/analyze-media-tool.js

@@ -21,13 +21,13 @@ function isMediaPath(filePath) {
 export const ANALYZE_MEDIA_PARAMETERS = {
     type: 'object',
     properties: {
-        file_path: { type: 'string', description: '媒体文件路径（图片/音频/视频）' },
+        file_path: { type: 'string', description: 'Media file path (image/audio/video)' },
     },
     required: ['file_path'],
 };
 export class AnalyzeMediaBuiltinTool extends BuiltinBaseTool {
     name = 'analyze_media';
-    description = '分析本地图片、音频或视频文件，返回可读摘要（转写/尺寸/格式）；不要对媒体文件使用 read_file。';
+    description = 'Analyze a local image, audio, or video file and return a readable summary (transcript/dimensions/format). Do not use read_file for media files.';
     parameters = ANALYZE_MEDIA_PARAMETERS;
     kind = 'file';
     constructor() {

package/lib/builtin/analyze-media-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-media-tool.js","sourceRoot":"","sources":["../../src/builtin/analyze-media-tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"analyze-media-tool.js","sourceRoot":"","sources":["../../src/builtin/analyze-media-tool.ts"],"names":[],"mappings":"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"}

package/lib/builtin/ask-user-session-service.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ask_user 常驻会话服务 — 单轨 middleware、排队、命令 bypass、Prompt/私聊统一。
+ */
+import { type Adapter, type Message, type Plugin } from '@zhin.js/core';
+export type AskUserSessionKind = 'prompt' | 'sensitive_dm';
+export interface AskUserOpenSpec {
+    sessionId: string;
+    kind: AskUserSessionKind;
+    message: Message;
+    questionType: string;
+    args: Record<string, unknown>;
+    timeoutMs: number;
+    botMaster?: string;
+    adapter?: Adapter;
+    groupOrigin?: Message;
+}
+export declare class AskUserSessionService {
+    private readonly plugin;
+    private readonly ownerQueues;
+    private readonly promptWaits;
+    private readonly disposeMiddleware;
+    constructor(plugin: Plugin);
+    static install(plugin: Plugin): AskUserSessionService;
+    static resetForTests(): void;
+    static get(): AskUserSessionService | undefined;
+    matchInbound(message: Message, root?: Plugin): 'consume' | 'bypass' | 'ignore';
+    isPendingReply(message: Message, root?: Plugin): boolean;
+    open(spec: AskUserOpenSpec): Promise<string>;
+    private hasPendingForMessage;
+    private tryMatchPrompt;
+    private tryMatchSensitiveDm;
+    private openPrompt;
+    private openSensitiveDm;
+    private sendSensitiveQuestion;
+    private timeoutFallback;
+    private finishOwnerEntry;
+    private resolveEndpointMaster;
+    private middleware;
+}
+//# sourceMappingURL=ask-user-session-service.d.ts.map

package/lib/builtin/ask-user-session-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-session-service.d.ts","sourceRoot":"","sources":["../../src/builtin/ask-user-session-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,OAAO,EAEZ,KAAK,MAAM,EAEZ,MAAM,eAAe,CAAC;AAQvB,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,cAAc,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA4BD,qBAAa,qBAAqB;IAKpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmC;IAC/D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAa;gBAElB,MAAM,EAAE,MAAM;IAI3C,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB;IAOrD,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B,MAAM,CAAC,GAAG,IAAI,qBAAqB,GAAG,SAAS;IAI/C,YAAY,CACV,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,SAAS,GAAG,QAAQ,GAAG,QAAQ;IASlC,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO;IAIlD,IAAI,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAOlD,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,mBAAmB;YAcb,UAAU;IA0DxB,OAAO,CAAC,eAAe;YA4BT,qBAAqB;IAgCnC,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,UAAU,CAkChB;CACH"}