@geminixiang/mikan 1.0.0-beta.4 → 1.0.0-beta.41

package/dist/harness/subagent-profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-profiles.js","sourceRoot":"","sources":["../../src/harness/subagent-profiles.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Subagent profiles: the curated capability sets a subagent may be launched\n * with.\n *\n * Profiles exist because the two halves of a subagent definition have\n * different owners. What a profile *does* — its tools, required evidence,\n * prompt and budget — is portable, so it ships as a built-in below and is\n * versioned with the code. Which model runs it is per-installation, so it is\n * overridden by `<workspaceDir>/agents/<name>.md`.\n *\n * A workspace file therefore *patches* the built-in of the same name rather\n * than replacing it: overriding only `model:` must not force an operator to\n * restate the tools and prompt, because a restated copy silently drifts from\n * the built-in it was cloned from. A file whose name matches no built-in\n * defines a new profile and must supply `tools` itself.\n *\n * A malformed file is reported as a diagnostic and skipped, never thrown:\n * these are hand-edited, and one typo must not take the whole workspace down.\n */\nimport { existsSync, readFileSync, readdirSync } from \"node:fs\";\nimport { basename, join } from \"node:path\";\nimport type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type {\n  LoadSubagentProfilesResult,\n  SubagentModelSpec,\n  SubagentProfile,\n  SubagentProfileDiagnostic,\n} from \"./types.js\";\n\nexport type { LoadSubagentProfilesResult, SubagentProfileDiagnostic } from \"./types.js\";\nimport { parseFrontmatter } from \"./skills.js\";\n\nconst BUILTIN_PROFILES: SubagentProfile[] = [\n  {\n    name: \"worker\",\n    description: \"Completes a bounded general-purpose task without adding domain assumptions\",\n    systemPrompt: [\n      \"You are a general-purpose worker responsible for one clearly bounded delegated task.\",\n      \"\",\n      \"Use `read` and `bash` to inspect the actual workspace state, and use `edit` or `write` only when the assignment requires changes. Follow applicable skill instructions, preserve behavior outside the stated scope, and do not invent requirements or broaden the task. Verify concrete outputs before reporting success; if the assignment lacks information or a required capability, state the limitation instead of guessing.\",\n      \"\",\n      \"Keep verbose discovery and command output in this isolated run. Return the completed result, files or artifacts changed, verification performed, and any unresolved blocker.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"edit\", \"write\"],\n    requiredTools: [\"read\", \"bash\"],\n    thinkingLevel: \"high\",\n    maxTurns: 30,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"software-engineer\",\n    description:\n      \"Owns software investigation, implementation, integration, and technical verification\",\n    systemPrompt: [\n      \"You are the software engineer responsible for one delegated technical outcome.\",\n      \"\",\n      \"Apply the relevant engineering and vendor skill instructions. Use `bash` to inspect repositories, run development tools, diagnose browser or integration behavior, and make only changes explicitly included in the assignment. Trace failures to their technical cause, preserve existing contracts outside scope, and verify work with the narrowest meaningful checks. Do not treat plausible output as evidence of success.\",\n      \"\",\n      \"Keep source discovery, build logs, browser traces, and repetitive diagnostics in this isolated run. Return the implemented or diagnosed outcome, decisive technical evidence, changed artifact paths when applicable, verification results, and remaining engineering risk.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"edit\", \"write\"],\n    requiredTools: [\"read\", \"bash\"],\n    thinkingLevel: \"high\",\n    maxTurns: 35,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"devops-engineer\",\n    description:\n      \"Owns cloud access, environments, deployments, and production workflow reliability\",\n    systemPrompt: [\n      \"You are the DevOps engineer responsible for one delegated infrastructure or production-operations outcome.\",\n      \"\",\n      \"Apply the relevant setup, GCP, repository-access, service-status, and production workflow skill instructions. Use `bash` to inspect current state before acting. Respect the named project, environment, principal, and resource scope; protect credentials; prefer least privilege; and check idempotency before writes, retries, or provisioning. Do not broaden access or repeat a non-idempotent operation without explicit authorization and evidence that it is needed.\",\n      \"\",\n      \"Keep verbose CLI, API, and job logs in this isolated run. Return the resulting state, affected resources or job identifiers, verification performed, and concrete follow-up or rollback information.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"edit\", \"write\", \"event\", \"sandbox\"],\n    requiredTools: [\"read\", \"bash\", \"sandbox\"],\n    thinkingLevel: \"high\",\n    maxTurns: 40,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"data-scientist\",\n    description:\n      \"Owns metric definition, data analysis, reconciliation, and defensible conclusions\",\n    systemPrompt: [\n      \"You are the data scientist responsible for answering one delegated quantitative question.\",\n      \"\",\n      \"Apply the relevant Metabase, GAM, accounting, billing, reporting, and parser skill instructions. Use `bash` to run the prescribed queries and analysis tools. Establish the time range, timezone, filters, dimensions, population, and metric definitions before interpreting results. Reconcile totals and cross-check consequential figures when practical. Separate source values, derived calculations, and inference; never fill missing data with guesses.\",\n      \"\",\n      \"Keep verbose rows and query output in this isolated run. Return the conclusion, key figures with units and scope, methodology and checks, and limitations that affect confidence.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    requiredTools: [\"read\", \"bash\"],\n    thinkingLevel: \"high\",\n    maxTurns: 35,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"account-manager\",\n    description:\n      \"Owns existing-client onboarding, account coordination, and delivery follow-through\",\n    systemPrompt: [\n      \"You are the account manager responsible for one delegated existing-client outcome.\",\n      \"\",\n      \"Apply the relevant onboarding, publisher account, slot, workspace, meeting, and communication skill instructions. Use `bash` to inspect the current customer and account state before acting. Preserve supplied commercial and technical requirements, coordinate dependencies, avoid duplicate account changes, and clearly distinguish completed work from items awaiting another owner. Do not invent customer approval or make an external commitment beyond the assignment.\",\n      \"\",\n      \"Keep verbose records and operational output in this isolated run. Return the customer-facing outcome, account or artifact identifiers, decisions and blockers, and the next owner and action where follow-through remains.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\", \"event\"],\n    requiredTools: [\"read\", \"bash\"],\n    thinkingLevel: \"high\",\n    maxTurns: 30,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"business-development\",\n    description:\n      \"Owns prospect research, qualification, contact discovery, and outreach preparation\",\n    systemPrompt: [\n      \"You are the business development specialist responsible for one delegated growth opportunity.\",\n      \"\",\n      \"Apply the relevant prospecting, website sampling, contact-finding, email-validation, and client-approach skill instructions. Use `bash` to gather and verify public evidence. Evaluate fit against the supplied criteria, distinguish verified contacts from inferred ones, and preserve source URLs. Do not contact prospects, submit forms, or represent that outreach occurred unless the assignment explicitly authorizes it.\",\n      \"\",\n      \"Keep raw pages, candidate lists, and repetitive validation output in this isolated run. Return qualified opportunities, supporting evidence, confidence and disqualifiers, and a concise recommended next action.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    requiredTools: [\"read\", \"bash\"],\n    thinkingLevel: \"high\",\n    maxTurns: 30,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"creative-producer\",\n    description: \"Owns media deliverables from creative brief through verified production output\",\n    systemPrompt: [\n      \"You are the creative producer responsible for one delegated media deliverable.\",\n      \"\",\n      \"Apply the relevant source acquisition, storyboard, video, image, speech, lipsync, and generation-provider skill instructions. Use `bash` to run the prescribed production tools. Confirm the brief, audience, format, dimensions, duration, language, and source inputs; use discovery commands rather than guessing provider or model identifiers. Preserve provenance and generation parameters, and verify that claimed outputs exist and match the requested technical properties.\",\n      \"\",\n      \"Keep generation logs, intermediate assets, and provider polling in this isolated run. Return deliverable paths or external identifiers, a concise production summary, verification results, and unresolved creative, quality, or rights constraints.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    requiredTools: [\"read\", \"bash\", \"write\"],\n    thinkingLevel: \"high\",\n    maxTurns: 40,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"ad-operations-specialist\",\n    description:\n      \"Owns ad serving setup, delivery diagnostics, policy checks, and operational health\",\n    systemPrompt: [\n      \"You are the ad operations specialist responsible for one delegated advertising-delivery outcome.\",\n      \"\",\n      \"Apply the relevant GAM, ads.txt, player detection, targeting, behavior, monitoring, and policy skill instructions. Use `bash` to run the prescribed browser and reporting tools. Establish the site, account, slot, time window, geography, device, and consent conditions; distinguish configuration, eligibility, request, impression, and playback evidence. Reproduce dynamic behavior when practical, and do not change live serving configuration unless explicitly authorized.\",\n      \"\",\n      \"Keep browser traces, HAR data, report rows, and repetitive diagnostics in this isolated run. Return the operational conclusion, decisive delivery evidence, affected inventory, remediation or escalation owner, and uncertainty that could change the diagnosis.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    requiredTools: [\"read\", \"bash\"],\n    thinkingLevel: \"high\",\n    maxTurns: 35,\n    maxTokens: 100_000,\n  },\n  {\n    name: \"analysis-only\",\n    description: \"Analyzes supplied task input without claiming external verification\",\n    systemPrompt: [\n      \"You analyze only the task text and structured dependency input supplied to this run.\",\n      \"\",\n      \"Do not claim to have inspected files, executed commands, accessed URLs, or verified external state. Clearly distinguish dependency-provided facts from your own analysis. If the supplied evidence is insufficient, state the limitation instead of inventing details.\",\n    ].join(\"\\n\"),\n    tools: [],\n    requiredTools: [],\n    thinkingLevel: \"high\",\n    maxTurns: 20,\n    maxTokens: 100_000,\n  },\n];\n\nconst THINKING_LEVELS = new Set<ThinkingLevel>([\n  \"off\",\n  \"minimal\",\n  \"low\",\n  \"medium\",\n  \"high\",\n  \"xhigh\",\n]);\n\n/** Parse a comma-separated tool list. The literal `none` is an empty grant. */\nfunction csv(value: string): string[] {\n  if (value.trim() === \"none\") return [];\n  return [\n    ...new Set(\n      value\n        .split(\",\")\n        .map((item) => item.trim())\n        .filter(Boolean),\n    ),\n  ];\n}\n\nfunction parseModel(value: string): SubagentModelSpec {\n  const separator = value.indexOf(\"/\");\n  if (separator <= 0 || separator === value.length - 1) {\n    throw new Error(`model must be provider/id, got ${value}`);\n  }\n  return { provider: value.slice(0, separator), id: value.slice(separator + 1) };\n}\n\nfunction parseThinking(value: string): ThinkingLevel {\n  if (!THINKING_LEVELS.has(value as ThinkingLevel)) {\n    throw new Error(`unknown thinking level: ${value}`);\n  }\n  return value as ThinkingLevel;\n}\n\nfunction parsePositiveInteger(value: string, field: string): number {\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed) || parsed <= 0) {\n    throw new Error(`${field} must be a positive integer`);\n  }\n  return parsed;\n}\n\nfunction parseNonNegativeNumber(value: string, field: string): number {\n  const parsed = Number(value);\n  if (!Number.isFinite(parsed) || parsed < 0) {\n    throw new Error(`${field} must be a non-negative number`);\n  }\n  return parsed;\n}\n\n/** Apply `field` from frontmatter onto `patch` only when the file sets it. */\nfunction applyField<K extends keyof SubagentProfile>(\n  patch: Partial<SubagentProfile>,\n  values: Record<string, string>,\n  key: string,\n  field: K,\n  parse: (value: string) => SubagentProfile[K],\n): void {\n  const raw = values[key];\n  if (raw === undefined) return;\n  patch[field] = parse(raw);\n}\n\n/**\n * Build the overlay a single file contributes. Throws with a human-readable\n * message on malformed input; the caller turns that into a diagnostic.\n */\nfunction parseProfilePatch(filePath: string, base: SubagentProfile | undefined): SubagentProfile {\n  const { values, body } = parseFrontmatter(readFileSync(filePath, \"utf-8\"));\n  const name = basename(filePath, \".md\");\n  const patch: Partial<SubagentProfile> = {};\n\n  applyField(patch, values, \"description\", \"description\", (value) => value.trim());\n  applyField(patch, values, \"tools\", \"tools\", csv);\n  applyField(patch, values, \"required_tools\", \"requiredTools\", csv);\n  applyField(patch, values, \"model\", \"model\", parseModel);\n  applyField(patch, values, \"thinking\", \"thinkingLevel\", parseThinking);\n  applyField(patch, values, \"max_turns\", \"maxTurns\", (v) => parsePositiveInteger(v, \"max_turns\"));\n  applyField(patch, values, \"max_tokens\", \"maxTokens\", (v) =>\n    parsePositiveInteger(v, \"max_tokens\"),\n  );\n  applyField(patch, values, \"max_cost_usd\", \"maxCostUsd\", (v) =>\n    parseNonNegativeNumber(v, \"max_cost_usd\"),\n  );\n  applyField(patch, values, \"max_duration_ms\", \"maxDurationMs\", (v) =>\n    parsePositiveInteger(v, \"max_duration_ms\"),\n  );\n\n  const systemPrompt = body.trim() || base?.systemPrompt;\n  if (!base && patch.tools === undefined) {\n    throw new Error(`tools is required for a new profile (no built-in named ${name})`);\n  }\n  if (!systemPrompt) {\n    throw new Error(`a new profile needs prompt text in the file body`);\n  }\n\n  const merged: SubagentProfile = {\n    ...base,\n    ...patch,\n    name,\n    description: patch.description || base?.description || name,\n    systemPrompt,\n    tools: patch.tools ?? base?.tools ?? [],\n    requiredTools: patch.requiredTools ?? base?.requiredTools ?? [],\n  };\n\n  const ungranted = merged.requiredTools.filter((tool) => !merged.tools.includes(tool));\n  if (ungranted.length > 0) {\n    throw new Error(`required_tools must be included in tools: ${ungranted.join(\", \")}`);\n  }\n  return merged;\n}\n\n/**\n * Load the built-in profiles, then patch them with `<workspaceDir>/agents/*.md`.\n * Malformed files are reported and skipped, leaving the built-in in place.\n */\nexport function loadSubagentProfiles(workspaceDir: string): LoadSubagentProfilesResult {\n  const dir = join(workspaceDir, \"agents\");\n  const profiles = new Map(BUILTIN_PROFILES.map((profile) => [profile.name, profile]));\n  const diagnostics: SubagentProfileDiagnostic[] = [];\n  if (!existsSync(dir)) return { profiles, diagnostics };\n\n  let entries;\n  try {\n    entries = readdirSync(dir, { withFileTypes: true });\n  } catch (error) {\n    diagnostics.push({\n      type: \"warning\",\n      message: error instanceof Error ? error.message : String(error),\n      path: dir,\n    });\n    return { profiles, diagnostics };\n  }\n\n  for (const entry of entries) {\n    if (!entry.isFile() || !entry.name.endsWith(\".md\")) continue;\n    const filePath = join(dir, entry.name);\n    try {\n      const profile = parseProfilePatch(filePath, profiles.get(basename(entry.name, \".md\")));\n      profiles.set(profile.name, profile);\n    } catch (error) {\n      diagnostics.push({\n        type: \"warning\",\n        message: error instanceof Error ? error.message : String(error),\n        path: filePath,\n      });\n    }\n  }\n  return { profiles, diagnostics };\n}\n"]}

package/dist/harness/subagent-runner.d.ts

@@ -0,0 +1,45 @@
+import type { AgentMessage, AgentTool, ThinkingLevel } from "@earendil-works/pi-agent-core";
+import type { Api, Model } from "@earendil-works/pi-ai";
+import { type TSchema } from "@sinclair/typebox";
+import type { MikanModels } from "./models.js";
+import type { SubagentProfile } from "./types.js";
+import type { SubagentRunOutput, SubagentRunRequest, SubagentRunResult, SubagentUsageSink } from "./types.js";
+import { type SubagentSlotPool } from "../tools/subagent-slots.js";
+export declare const DEFAULT_SUBAGENT_BUDGET: {
+    readonly maxTurns: 100;
+    readonly maxCostUsd: 10;
+    readonly maxDurationMs: number;
+};
+/** Time allowed for an aborted subagent to settle before detached cleanup. */
+export declare const SUBAGENT_ABORT_GRACE_MS = 100;
+interface RunSubagentOptions<TOutputSchema extends TSchema | undefined = undefined> {
+    request: SubagentRunRequest<TOutputSchema>;
+    defaultModel: Model<Api>;
+    thinkingLevel: ThinkingLevel;
+    models: MikanModels;
+    workspaceDir: string;
+    availableTools: AgentTool[];
+    profiles?: ReadonlyMap<string, SubagentProfile>;
+    /** Process-wide launch pool shared by tool and extension invocations. */
+    slots?: SubagentSlotPool;
+    /** Host-snapshotted parent transcript; never sourced from the public request. */
+    parentMessages?: AgentMessage[];
+    /** Usage attribution sink snapshotted when this invocation begins. */
+    onUsage?: SubagentUsageSink;
+    /**
+     * Called as the run's visible activity changes, so a caller can show what
+     * this subagent is doing rather than only that it started. Best-effort: a
+     * throwing sink is logged and the run continues.
+     */
+    onActivity?: (activity: string) => void;
+}
+/**
+ * Execute one non-recursive, fresh subagent run. Never rejects: every
+ * failure — including request validation — is a result with a terminal
+ * status, so batch callers (`tasks` / `dag`) can never orphan in-flight
+ * sibling runs on one bad request. Usage is reported once, after the
+ * underlying run settles; an aborted run may report it from detached cleanup.
+ */
+export declare function runSubagent<TOutputSchema extends TSchema | undefined = undefined>(options: RunSubagentOptions<TOutputSchema>): Promise<SubagentRunResult<SubagentRunOutput<TOutputSchema>>>;
+export {};
+//# sourceMappingURL=subagent-runner.d.ts.map

package/dist/harness/subagent-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-runner.d.ts","sourceRoot":"","sources":["../../src/harness/subagent-runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,KAAK,EAAE,GAAG,EAAoB,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,KAAK,EAEV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EAEjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAKtF,eAAO,MAAM,uBAAuB;aAClC,QAAQ,EAAE,GAAG;aACb,UAAU,EAAE,EAAE;aACd,aAAa;CACL,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAuG3C,UAAU,kBAAkB,CAAC,aAAa,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS;IAChF,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAC3C,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,SAAS,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAChD,yEAAyE;IACzE,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,iFAAiF;IACjF,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;IAChC,sEAAsE;IACtE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAyRD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,aAAa,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EACrF,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,GACzC,OAAO,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC,CAc9D"}