@jiezhengj/subagent-oar-agy 0.2.8 → 0.3.0

package/provider/runs.d.ts

@@ -0,0 +1,143 @@
+/** 有界的 AGY 运行登记表：状态快照、活动摘要、取消请求与终态保留。 */
+import type { FailureCategory } from './agy/errors.js';
+/** 运行状态。 */
+export type RunState = 'starting' | 'running' | 'completed' | 'failed' | 'cancelled';
+/** 活动类型；`stderr` 只作诊断记录，不重置静默计时。 */
+export type ActivityKind = 'init' | 'step' | 'tool' | 'text' | 'result' | 'lifecycle' | 'stderr';
+/** 状态快照中的最近协议事件类型；活动类型 `step`/`tool`/`text` 统一映射为 `step_update`。 */
+export type ProtocolEventKind = 'init' | 'step_update' | 'result' | 'stderr' | 'lifecycle';
+/** 一次活动摘要。 */
+export interface ActivityEntry {
+    readonly seq: number;
+    readonly at: number;
+    readonly kind: ActivityKind;
+    readonly summary: string;
+    readonly stepIndex?: number;
+    readonly stepState?: string;
+    readonly toolName?: string;
+    readonly text?: string;
+}
+/** 运行记录；由提供方更新，查询时投影为快照。 */
+export interface RunRecord {
+    readonly childId: string;
+    readonly parentId: string;
+    state: RunState;
+    readonly startedAt: number;
+    readyAt?: number;
+    endedAt?: number;
+    lastActivityAt?: number;
+    lastEventKind?: ProtocolEventKind;
+    pid?: number;
+    conversationId?: string;
+    stepIndex?: number;
+    stepState?: string;
+    toolName?: string;
+    lastText?: string;
+    stopReason?: string;
+    failureCategory?: FailureCategory;
+    cancelRequestedAt?: number;
+    readonly activity: ActivityEntry[];
+    /** 运行清理钩子；插件卸载时用来终止尚未结算的进程。 */
+    teardown?: () => Promise<void>;
+}
+/** 状态查询输出中的一个运行。 */
+export interface RunView {
+    readonly childId: string;
+    readonly state: RunState;
+    readonly startedAt: string;
+    readonly readyAt: string | null;
+    readonly endedAt: string | null;
+    readonly elapsedMs: number;
+    readonly lastActivityAt: string | null;
+    readonly lastEventKind: ProtocolEventKind | null;
+    readonly pid: number | null;
+    readonly conversationId: string | null;
+    readonly stepIndex: number | null;
+    readonly stepState: string | null;
+    readonly toolName: string | null;
+    readonly lastText: string | null;
+    readonly stopReason: string | null;
+    readonly failureCategory: FailureCategory | null;
+    readonly cancelRequestedAt: string | null;
+    readonly activity: readonly RunViewActivity[];
+}
+/** 快照中的活动摘要。 */
+export interface RunViewActivity {
+    readonly seq: number;
+    readonly at: string;
+    readonly kind: ActivityKind;
+    readonly summary: string;
+    readonly stepIndex?: number;
+    readonly stepState?: string;
+    readonly toolName?: string;
+    readonly text?: string;
+}
+/** `status` 动作的完整输出。 */
+export interface StatusSnapshot {
+    readonly action: 'status';
+    readonly generatedAt: string;
+    readonly found: boolean;
+    readonly runs: readonly RunView[];
+}
+/** 取消受理结果。 */
+export interface CancelReceipt {
+    readonly accepted: boolean;
+    readonly reason: 'accepted' | 'already-requested' | 'already-ended' | 'not-found';
+    readonly requestedAt?: number;
+}
+/** 登记表配置。 */
+export interface RunRegistryOptions {
+    readonly activityLimit?: number;
+    readonly maxRecordsPerParent?: number;
+    readonly terminalRetentionMs?: number;
+    readonly now?: () => number;
+}
+/** 有界登记表。 */
+export declare class RunRegistry {
+    private readonly byParent;
+    private readonly byId;
+    private readonly timers;
+    private readonly activityLimit;
+    private readonly maxRecordsPerParent;
+    private readonly terminalRetentionMs;
+    private readonly now;
+    constructor(options?: RunRegistryOptions);
+    /** 登记一个新运行；childId 必须全局唯一。 */
+    register(parentId: string, childId: string, pid?: number): RunRecord;
+    /** 标记 `init` 已到达，进入 running。 */
+    markReady(record: RunRecord): void;
+    /** 记录一条协议事件/生命周期活动。 */
+    recordActivity(record: RunRecord, kind: Exclude<ActivityKind, 'stderr'>, data?: {
+        summary?: string;
+        stepIndex?: number;
+        stepState?: string;
+        toolName?: string;
+        text?: string;
+    }): void;
+    /** 记录 stderr 诊断；不重置静默计时，也不进入活动环。 */
+    recordStderr(record: RunRecord, summary: string): void;
+    /** 记录终态；重复调用无副作用。 */
+    recordTerminal(record: RunRecord, state: 'completed' | 'failed' | 'cancelled', info?: {
+        stopReason?: string;
+        failureCategory?: FailureCategory;
+        summary?: string;
+    }): void;
+    /** 请求取消；只登记请求，不直接改终态。 */
+    requestCancel(parentId: string, childId: string): CancelReceipt;
+    /** 生成状态快照；childId 指定时做父级隔离。 */
+    status(parentId: string, childId?: string): StatusSnapshot;
+    /** 停止全部计时器、终止未结算运行并清空登记表。 */
+    dispose(): Promise<void>;
+    /** 删除终态记录（测试与惰性清理共用）。 */
+    remove(record: RunRecord): void;
+    private pushActivity;
+    private armCleanup;
+    private cleanup;
+    private enforceLimit;
+    private view;
+}
+/** 取提供方与工具共用的默认登记表。 */
+export declare function getDefaultRunRegistry(): RunRegistry;
+/** 替换默认登记表（插件 apply 与测试使用）。 */
+export declare function setDefaultRunRegistry(registry: RunRegistry | undefined): void;
+//# sourceMappingURL=runs.d.ts.map

package/provider/runs.d.ts.map

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

package/provider/runs.js

@@ -0,0 +1,280 @@
+/** 有界的 AGY 运行登记表：状态快照、活动摘要、取消请求与终态保留。 */
+const DEFAULT_ACTIVITY_LIMIT = 20;
+const DEFAULT_MAX_RECORDS = 50;
+const DEFAULT_RETENTION_MS = 300_000;
+/** 活动类型到协议事件类型的映射；保持状态契约的 `step_update` 语义。 */
+function protocolEventKind(kind) {
+    if (kind === 'step' || kind === 'tool' || kind === 'text')
+        return 'step_update';
+    return kind;
+}
+/** 截断字符串到最多 N 个 Unicode 码点，避免代理对截断。 */
+function clip(text, max) {
+    const chars = Array.from(text);
+    return chars.length <= max ? text : chars.slice(0, max).join('');
+}
+/** 有界登记表。 */
+export class RunRegistry {
+    byParent = new Map();
+    byId = new Map();
+    timers = new Map();
+    activityLimit;
+    maxRecordsPerParent;
+    terminalRetentionMs;
+    now;
+    constructor(options = {}) {
+        this.activityLimit = options.activityLimit ?? DEFAULT_ACTIVITY_LIMIT;
+        this.maxRecordsPerParent = options.maxRecordsPerParent ?? DEFAULT_MAX_RECORDS;
+        this.terminalRetentionMs = options.terminalRetentionMs ?? DEFAULT_RETENTION_MS;
+        this.now = options.now ?? (() => Date.now());
+    }
+    /** 登记一个新运行；childId 必须全局唯一。 */
+    register(parentId, childId, pid) {
+        this.cleanup();
+        const existing = this.byId.get(childId);
+        if (existing !== undefined)
+            return existing;
+        const record = {
+            childId,
+            parentId,
+            state: 'starting',
+            startedAt: this.now(),
+            ...(pid === undefined ? {} : { pid }),
+            activity: [],
+        };
+        this.byId.set(childId, record);
+        const group = this.byParent.get(parentId);
+        if (group === undefined)
+            this.byParent.set(parentId, [record]);
+        else
+            group.push(record);
+        this.enforceLimit(parentId);
+        return record;
+    }
+    /** 标记 `init` 已到达，进入 running。 */
+    markReady(record) {
+        if (record.state !== 'starting')
+            return;
+        const at = this.now();
+        record.state = 'running';
+        record.readyAt = at;
+        record.lastActivityAt = at;
+        record.lastEventKind = 'init';
+        this.pushActivity(record, { at, kind: 'init', summary: 'AGY ready' });
+    }
+    /** 记录一条协议事件/生命周期活动。 */
+    recordActivity(record, kind, data = {}) {
+        if (record.state === 'completed' || record.state === 'failed' || record.state === 'cancelled')
+            return;
+        const at = this.now();
+        if (kind !== 'lifecycle' || record.state === 'running') {
+            record.lastActivityAt = at;
+            record.lastEventKind = protocolEventKind(kind);
+        }
+        if (data.stepIndex !== undefined)
+            record.stepIndex = data.stepIndex;
+        if (data.stepState !== undefined)
+            record.stepState = data.stepState;
+        if (data.toolName !== undefined)
+            record.toolName = data.toolName;
+        if (data.text !== undefined)
+            record.lastText = clip(data.text, 200);
+        const summary = clip(data.summary ?? data.text ?? kind, 160);
+        const last = record.activity[record.activity.length - 1];
+        if (kind === 'text' && last?.kind === 'text') {
+            // 连续 text_delta 只更新最后一条，避免 20 个槽位被 token 填满。
+            const merged = {
+                seq: last.seq,
+                at,
+                kind,
+                summary,
+                ...(last.stepIndex === undefined ? {} : { stepIndex: last.stepIndex }),
+                ...(last.stepState === undefined ? {} : { stepState: last.stepState }),
+                ...(last.toolName === undefined ? {} : { toolName: last.toolName }),
+                ...(data.text === undefined ? {} : { text: clip(data.text, 200) }),
+            };
+            record.activity[record.activity.length - 1] = merged;
+            return;
+        }
+        this.pushActivity(record, {
+            at,
+            kind,
+            summary,
+            ...(data.stepIndex === undefined ? {} : { stepIndex: data.stepIndex }),
+            ...(data.stepState === undefined ? {} : { stepState: data.stepState }),
+            ...(data.toolName === undefined ? {} : { toolName: data.toolName }),
+            ...(data.text === undefined ? {} : { text: clip(data.text, 200) }),
+        });
+    }
+    /** 记录 stderr 诊断；不重置静默计时，也不进入活动环。 */
+    recordStderr(record, summary) {
+        if (record.state === 'completed' || record.state === 'failed' || record.state === 'cancelled')
+            return;
+        record.lastEventKind = 'stderr';
+        void summary;
+    }
+    /** 记录终态；重复调用无副作用。 */
+    recordTerminal(record, state, info = {}) {
+        if (record.state === 'completed' || record.state === 'failed' || record.state === 'cancelled')
+            return;
+        const at = this.now();
+        record.state = state;
+        record.endedAt = at;
+        record.stopReason = info.stopReason;
+        record.failureCategory = info.failureCategory;
+        record.lastActivityAt = at;
+        record.lastEventKind = 'lifecycle';
+        this.pushActivity(record, {
+            at,
+            kind: 'lifecycle',
+            summary: clip(info.summary ?? `run ${state}`, 160),
+        });
+        this.armCleanup(record);
+        this.enforceLimit(record.parentId);
+    }
+    /** 请求取消；只登记请求，不直接改终态。 */
+    requestCancel(parentId, childId) {
+        this.cleanup();
+        const record = this.byId.get(childId);
+        if (record === undefined || record.parentId !== parentId) {
+            return { accepted: false, reason: 'not-found' };
+        }
+        if (record.state === 'completed' || record.state === 'failed' || record.state === 'cancelled') {
+            return { accepted: false, reason: 'already-ended' };
+        }
+        if (record.cancelRequestedAt !== undefined) {
+            return { accepted: false, reason: 'already-requested', requestedAt: record.cancelRequestedAt };
+        }
+        const at = this.now();
+        record.cancelRequestedAt = at;
+        return { accepted: true, reason: 'accepted', requestedAt: at };
+    }
+    /** 生成状态快照；childId 指定时做父级隔离。 */
+    status(parentId, childId) {
+        this.cleanup();
+        const generatedAt = new Date(this.now()).toISOString();
+        if (childId !== undefined) {
+            const record = this.byId.get(childId);
+            if (record === undefined || record.parentId !== parentId) {
+                return { action: 'status', generatedAt, found: false, runs: [] };
+            }
+            return { action: 'status', generatedAt, found: true, runs: [this.view(record)] };
+        }
+        const runs = (this.byParent.get(parentId) ?? [])
+            .slice()
+            .sort((a, b) => b.startedAt - a.startedAt)
+            .map(record => this.view(record));
+        return { action: 'status', generatedAt, found: true, runs };
+    }
+    /** 停止全部计时器、终止未结算运行并清空登记表。 */
+    async dispose() {
+        for (const timer of this.timers.values())
+            clearTimeout(timer);
+        this.timers.clear();
+        const records = [...this.byId.values()];
+        await Promise.allSettled(records
+            .filter(record => record.state === 'starting' || record.state === 'running')
+            .map(record => record.teardown?.()));
+        this.byId.clear();
+        this.byParent.clear();
+    }
+    /** 删除终态记录（测试与惰性清理共用）。 */
+    remove(record) {
+        const timer = this.timers.get(record.childId);
+        if (timer !== undefined) {
+            clearTimeout(timer);
+            this.timers.delete(record.childId);
+        }
+        if (this.byId.get(record.childId) !== record)
+            return;
+        this.byId.delete(record.childId);
+        const group = this.byParent.get(record.parentId);
+        if (group === undefined)
+            return;
+        const index = group.indexOf(record);
+        if (index !== -1)
+            group.splice(index, 1);
+        if (group.length === 0)
+            this.byParent.delete(record.parentId);
+    }
+    pushActivity(record, entry) {
+        const seq = record.activity.length === 0 ? 1 : record.activity[record.activity.length - 1].seq + 1;
+        record.activity.push({ seq, ...entry });
+        while (record.activity.length > this.activityLimit)
+            record.activity.shift();
+    }
+    armCleanup(record) {
+        const existing = this.timers.get(record.childId);
+        if (existing !== undefined)
+            clearTimeout(existing);
+        const timer = setTimeout(() => {
+            this.timers.delete(record.childId);
+            this.remove(record);
+        }, this.terminalRetentionMs);
+        timer.unref?.();
+        this.timers.set(record.childId, timer);
+    }
+    cleanup() {
+        const now = this.now();
+        for (const record of [...this.byId.values()]) {
+            if (record.endedAt !== undefined &&
+                now - record.endedAt >= this.terminalRetentionMs) {
+                this.remove(record);
+            }
+        }
+    }
+    enforceLimit(parentId) {
+        const group = this.byParent.get(parentId);
+        if (group === undefined)
+            return;
+        while (group.length > this.maxRecordsPerParent) {
+            const index = group.findIndex(record => record.endedAt !== undefined && record.state !== 'starting' && record.state !== 'running');
+            if (index === -1)
+                break;
+            this.remove(group[index]);
+        }
+    }
+    view(record) {
+        const now = this.now();
+        return {
+            childId: record.childId,
+            state: record.state,
+            startedAt: new Date(record.startedAt).toISOString(),
+            readyAt: record.readyAt === undefined ? null : new Date(record.readyAt).toISOString(),
+            endedAt: record.endedAt === undefined ? null : new Date(record.endedAt).toISOString(),
+            elapsedMs: Math.max(0, (record.endedAt ?? now) - record.startedAt),
+            lastActivityAt: record.lastActivityAt === undefined ? null : new Date(record.lastActivityAt).toISOString(),
+            lastEventKind: record.lastEventKind ?? null,
+            pid: record.pid ?? null,
+            conversationId: record.conversationId ?? null,
+            stepIndex: record.stepIndex ?? null,
+            stepState: record.stepState ?? null,
+            toolName: record.toolName ?? null,
+            lastText: record.lastText ?? null,
+            stopReason: record.stopReason ?? null,
+            failureCategory: record.failureCategory ?? null,
+            cancelRequestedAt: record.cancelRequestedAt === undefined ? null : new Date(record.cancelRequestedAt).toISOString(),
+            activity: record.activity.map(entry => ({
+                seq: entry.seq,
+                at: new Date(entry.at).toISOString(),
+                kind: entry.kind,
+                summary: entry.summary,
+                ...(entry.stepIndex === undefined ? {} : { stepIndex: entry.stepIndex }),
+                ...(entry.stepState === undefined ? {} : { stepState: entry.stepState }),
+                ...(entry.toolName === undefined ? {} : { toolName: entry.toolName }),
+                ...(entry.text === undefined ? {} : { text: entry.text }),
+            })),
+        };
+    }
+}
+let defaultRegistry;
+/** 取提供方与工具共用的默认登记表。 */
+export function getDefaultRunRegistry() {
+    defaultRegistry ??= new RunRegistry();
+    return defaultRegistry;
+}
+/** 替换默认登记表（插件 apply 与测试使用）。 */
+export function setDefaultRunRegistry(registry) {
+    defaultRegistry = registry;
+}
+//# sourceMappingURL=runs.js.map

package/provider/runs.js.map

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

package/tool.js

@@ -9,9 +9,12 @@
 
 import Schema from '@deepseek-ai/schemastery'
 import { defineTool } from '@deepseek-ai/dsh-tools'
+import { getDefaultRunRegistry } from './provider/runs.js'
+import { redactSensitive } from './provider/agy/errors.js'
 
 const OFFICIAL_TOOL = '@deepseek-ai/dsh-experimental-tool-subagent-oar'
 const DEFAULT_TOOL_NAME = 'subagent_oar_agy'
+const DEFAULT_CONTROL_TOOL_NAME = 'subagent_oar_agy_control'
 
 /** 插件名（Cordis 识别用）。 */
 export const name = 'subagent-oar-agy-tool'
@@ -23,6 +26,7 @@ export const inject = ['tools', 'subagents']
 export const Config = Schema.object({
   providers: Schema.dict(Schema.string().min(1)).required(),
   toolName: Schema.string().min(1).default(DEFAULT_TOOL_NAME),
+  controlToolName: Schema.string().min(1).default(DEFAULT_CONTROL_TOOL_NAME),
 })
 
 /**
@@ -118,6 +122,95 @@ export function createFallbackTool(providers, toolName, ctx) {
   })
 }
 
+
+/** 构造控制工具：status 只读快照，cancel 通过官方 interrupt 授权取消。 */
+export function createControlTool(ctx, config, registry) {
+  return defineTool({
+    name: config.controlToolName ?? DEFAULT_CONTROL_TOOL_NAME,
+    description:
+      'Inspect or cancel an AGY delegation started by this parent session. status returns a bounded snapshot of direct AGY runs; cancel requests asynchronous cancellation. status never starts, resumes, or changes a run.',
+    parameters: {
+      action: {
+        type: 'string',
+        required: true,
+        enum: ['status', 'cancel'],
+        description: 'status: read-only snapshot; cancel: request cancellation of one childId.',
+      },
+      childId: {
+        type: 'string',
+        description: 'External child id from subagent_oar_agy. Optional for status (list) and required for cancel.',
+      },
+    },
+    output: {
+      schema: { type: 'object', additionalProperties: true },
+      render: (_args, value) => [{ type: 'text', text: JSON.stringify(value) }],
+    },
+    isConcurrencySafe: () => true,
+    async execute(args, exec) {
+      const parent = exec.agent
+      const action = args.action
+      if (parent === undefined) {
+        // 规则 7：取消缺少 exec.agent 时只返回不可用收据；status 仍需调用者身份。
+        if (action === 'cancel') {
+          return {
+            action: 'cancel',
+            childId: typeof args.childId === 'string' ? args.childId : '',
+            accepted: false,
+            reason: 'unavailable',
+          }
+        }
+        throw new Error(`${config.controlToolName ?? DEFAULT_CONTROL_TOOL_NAME} requires a calling agent`)
+      }
+      const parentId = String(parent.id)
+      const activeRegistry = registry ?? getDefaultRunRegistry()
+      if (action === 'status') return activeRegistry.status(parentId, args.childId)
+      if (typeof args.childId !== 'string' || args.childId.length === 0) {
+        throw new Error(`${config.controlToolName ?? DEFAULT_CONTROL_TOOL_NAME}: childId is required for cancel`)
+      }
+      const receipt = activeRegistry.requestCancel(parentId, args.childId)
+      const requestedAt = receipt.requestedAt === undefined
+        ? undefined
+        : new Date(receipt.requestedAt).toISOString()
+      if (receipt.reason === 'not-found' || receipt.reason === 'already-ended') {
+        return {
+          action: 'cancel',
+          childId: args.childId,
+          accepted: false,
+          reason: receipt.reason,
+        }
+      }
+      try {
+        ctx.subagents.interrupt(args.childId, { kind: 'ancestor', agent: parent })
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error)
+        if (typeof ctx.logger?.warn === 'function') ctx.logger.warn(`subagent_oar_agy_control cancel failed: ${redactSensitive(message)}`)
+        return {
+          action: 'cancel',
+          childId: args.childId,
+          accepted: false,
+          reason: 'unavailable',
+        }
+      }
+      return {
+        action: 'cancel',
+        childId: args.childId,
+        // 规则 2：重复请求仍是已受理；首次与重复都返回 accepted:true。
+        accepted: receipt.reason === 'accepted' || receipt.reason === 'already-requested',
+        reason: receipt.reason,
+        ...(requestedAt === undefined ? {} : { requestedAt }),
+      }
+    },
+    presentCall: args => ({ card: 'generic', title: args.action === 'cancel' ? 'cancel AGY delegation' : 'AGY run status', rawInput: args }),
+  })
+}
+
+/** 注册控制工具，返回精确 disposer。 */
+export function registerControlTool(ctx, config, registry) {
+  const name = config.controlToolName ?? DEFAULT_CONTROL_TOOL_NAME
+  if (name.trim().length === 0) throw new Error('subagent_oar_agy: controlToolName must be non-empty')
+  return ctx.tools.register(createControlTool(ctx, config, registry))
+}
+
 /**
  * 注册内置回退工具。
  * @param ctx - 插件上下文
@@ -141,16 +234,19 @@ export function registerFallback(ctx, config) {
  * @param resolveTool - 官方模块解析器，测试可注入
  * @returns `'official'` 或 `'fallback'`
  */
-export async function mountTool(ctx, config, resolveTool = loadOfficialTool) {
+export async function mountTool(ctx, config, resolveTool = loadOfficialTool, registry) {
   const official = await resolveTool()
+  const officialConfig = { providers: config.providers, toolName: config.toolName ?? DEFAULT_TOOL_NAME }
   if (official?.apply !== undefined) {
-    ctx.plugin(official, config)
+    ctx.plugin(official, officialConfig)
+    registerControlTool(ctx, config, registry)
     return 'official'
   }
   const warning = `[subagent_oar_agy] ${OFFICIAL_TOOL} is not resolvable; using the bundled one-shot tool fallback. Install the official package to restore the official implementation.`
   if (typeof ctx.logger?.warn === 'function') ctx.logger.warn(warning)
   else console.warn(warning)
   registerFallback(ctx, config)
+  registerControlTool(ctx, config, registry)
   return 'fallback'
 }