@geminixiang/mikan 1.0.0-beta.7 → 1.0.0-beta.71

package/dist/harness/tools/subagent.d.ts

@@ -0,0 +1,85 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { type TSchema } from "@sinclair/typebox";
+import type { SubagentRunOutput, SubagentRunRequest, SubagentRunResult } from "../types.js";
+import type { SubagentProgressNode, SubagentProgressSnapshot } from "../../types.js";
+declare const subagentSchema: import("@sinclair/typebox").TObject<{
+    parentContext: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        mode: import("@sinclair/typebox").TLiteral<"normalized">;
+        recentTurns: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    }>>;
+    outputSchema: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    budget: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        maxTokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    }>>;
+    task: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    profile: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    label: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    input: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    tasks: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        task: import("@sinclair/typebox").TString;
+        profile: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        label: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        input: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    }>>>;
+    dag: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        nodes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            task: import("@sinclair/typebox").TString;
+            profile: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            label: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            input: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+            id: import("@sinclair/typebox").TString;
+            dependsOn: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        }>>;
+        maxConcurrency: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    }>>;
+}>;
+/**
+ * `hooks` carries host-side callbacks rather than widening the request: the
+ * request is the public shape the model asks for, and a
+ * progress sink belongs to whoever is displaying the run.
+ */
+type RunSubagent = <TOutputSchema extends TSchema | undefined = undefined>(request: SubagentRunRequest<TOutputSchema>, hooks?: {
+    onActivity?: (activity: string) => void;
+}) => Promise<SubagentRunResult<SubagentRunOutput<TOutputSchema>>>;
+/** What the model needs to choose a profile: what it is, and what it can do. */
+interface SubagentProfileMenuEntry {
+    description: string;
+    tools?: string[];
+}
+/**
+ * Create the normal agent's bounded subagent delegation and DAG tool.
+ * `globalSlots` is the process-wide fan-out account shared across every
+ * conversation's tool instance; omitted, fan-out is bounded per run only.
+ *
+ * `profiles` must be non-empty: it is both the model-facing menu and the only
+ * way to grant a subagent any capability at all.
+ */
+export declare function createSubagentTool(runSubagent: RunSubagent, profiles: ReadonlyMap<string, SubagentProfileMenuEntry>): AgentTool<typeof subagentSchema>;
+/** Longest label the dashboard renders; longer ones are clamped, never rejected. */
+export declare const MAX_SUBAGENT_LABEL_CHARS = 100;
+/** The display bounds, applied once at construction and again on parse. */
+export declare function boundSubagentProgressNode(node: SubagentProgressNode): SubagentProgressNode;
+/**
+ * Parse a snapshot back off the untyped transport. All-or-nothing: one
+ * malformed node means the payload is not ours (any tool can put anything in
+ * `details`), so the whole candidate is rejected rather than partially shown.
+ */
+export declare function parseSubagentProgressSnapshot(value: unknown): SubagentProgressSnapshot | undefined;
+/**
+ * Project a live snapshot to its end-of-tool state: nodes still pending or
+ * running settle to the tool call's outcome. Metrics spread through
+ * unchanged — an unsettled node never reported any.
+ */
+export declare function settleSubagentProgress(snapshot: SubagentProgressSnapshot, isError: boolean): SubagentProgressSnapshot;
+/**
+ * Fold concurrent or successive subagent fan-outs into the single snapshot the
+ * dashboard renders. A run can call the subagent tool more than once; picking
+ * one snapshot would drop the others' cost and status, and alternating between
+ * them makes the live view flicker. Node ids are namespaced by source because
+ * each fan-out numbers its own nodes from zero.
+ */
+export declare function mergeSubagentProgress(snapshots: readonly SubagentProgressSnapshot[]): SubagentProgressSnapshot | undefined;
+/** The dashboard as response source Markdown; adapters own any conversion. */
+export declare function renderSubagentDashboard(snapshot: SubagentProgressSnapshot): string;
+export {};
+//# sourceMappingURL=subagent.d.ts.map

package/dist/harness/tools/subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/subagent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAA2B,MAAM,+BAA+B,CAAC;AACxF,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAI5F,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EAEzB,MAAM,gBAAgB,CAAC;AAkHxB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA0B,CAAC;AAM/C;;;;GAIG;AACH,KAAK,WAAW,GAAG,CAAC,aAAa,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EACvE,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,EAC1C,KAAK,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,KAChD,OAAO,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;AA2VlE,gFAAgF;AAChF,UAAU,wBAAwB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAyBD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,wBAAwB,CAAC,GACtD,SAAS,CAAC,OAAO,cAAc,CAAC,CA8ElC;AAKD,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,MAAM,CAAC;AA0C5C,2EAA2E;AAC3E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,oBAAoB,GAAG,oBAAoB,CAU1F;AAsCD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,wBAAwB,GAAG,SAAS,CAgBtC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,OAAO,GACf,wBAAwB,CAS1B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,wBAAwB,EAAE,GAC7C,wBAAwB,GAAG,SAAS,CAYtC;AAoFD,8EAA8E;AAC9E,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,CAOlF"}