@agimon-ai/po-team 0.0.0-alpha.0

package/dist/index.cjs

@@ -0,0 +1,49 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_atomicJson = require("./atomicJson-D0346bt5.cjs");
+const require_agentDiscovery = require("./agentDiscovery-Whwzc4dP.cjs");
+let node_fs = require("node:fs");
+node_fs = require_atomicJson.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_atomicJson.__toESM(node_path, 1);
+//#region src/services/subagentLaunchContract/index.ts
+/**
+* Public availability check for a subagent launch.
+*
+* Lives in adapters rather than services: resolving the contract stats the
+* working directory and reads agent definitions off disk.
+*/
+/** Lightweight public availability check using Doom Team's discovery rules. */
+async function resolveSubagentLaunchContract(input) {
+	const cwd = node_path.resolve(input.cwd);
+	try {
+		if (!node_fs.statSync(cwd).isDirectory()) return {
+			ok: false,
+			code: "invalid_cwd",
+			message: `cwd '${cwd}' is not a directory.`
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			code: "invalid_cwd",
+			message: `cwd '${cwd}' is not a directory.${error instanceof Error ? ` ${error.message}` : ""}`
+		};
+	}
+	const agent = new require_agentDiscovery.AgentDiscoveryService().find(cwd, input.agentScope ?? "both", input.agent);
+	if (!agent) return {
+		ok: false,
+		code: "missing_agent",
+		message: `Unknown agent: ${input.agent}`
+	};
+	return {
+		ok: true,
+		contract: {
+			agent,
+			cwd,
+			context: input.context ?? agent.defaultContext ?? "fresh"
+		}
+	};
+}
+//#endregion
+exports.resolveSubagentLaunchContract = resolveSubagentLaunchContract;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["path","fs","AgentDiscoveryService"],"sources":["../src/services/subagentLaunchContract/index.ts"],"sourcesContent":["/**\n * Public availability check for a subagent launch.\n *\n * Lives in adapters rather than services: resolving the contract stats the\n * working directory and reads agent definitions off disk.\n */\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\nimport type { AgentConfig, AgentScope } from '../../types/agent';\nimport { AgentDiscoveryService } from '../agentDiscovery';\n\nexport interface SubagentLaunchContractInput {\n  agent: string;\n  cwd: string;\n  task?: string;\n  agentScope?: AgentScope;\n  context?: 'fresh' | 'fork';\n  skill?: string | string[] | boolean;\n  artifacts?: boolean;\n}\n\nexport interface SubagentLaunchContract {\n  agent: AgentConfig;\n  cwd: string;\n  context: 'fresh' | 'fork';\n}\n\nexport type SubagentLaunchContractResult =\n  | { ok: true; contract: SubagentLaunchContract }\n  | { ok: false; code: 'invalid_cwd' | 'missing_agent'; message: string };\n\n/** Lightweight public availability check using Doom Team's discovery rules. */\nexport async function resolveSubagentLaunchContract(\n  input: SubagentLaunchContractInput,\n): Promise<SubagentLaunchContractResult> {\n  const cwd = path.resolve(input.cwd);\n  try {\n    if (!fs.statSync(cwd).isDirectory()) {\n      return { ok: false, code: 'invalid_cwd', message: `cwd '${cwd}' is not a directory.` };\n    }\n  } catch (error) {\n    const detail = error instanceof Error ? ` ${error.message}` : '';\n    return { ok: false, code: 'invalid_cwd', message: `cwd '${cwd}' is not a directory.${detail}` };\n  }\n\n  const agent = new AgentDiscoveryService().find(cwd, input.agentScope ?? 'both', input.agent);\n  if (!agent) return { ok: false, code: 'missing_agent', message: `Unknown agent: ${input.agent}` };\n\n  return {\n    ok: true,\n    contract: { agent, cwd, context: input.context ?? agent.defaultContext ?? 'fresh' },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAiCA,eAAsB,8BACpB,OACuC;CACvC,MAAM,MAAMA,UAAK,QAAQ,MAAM,GAAG;CAClC,IAAI;EACF,IAAI,CAACC,QAAG,SAAS,GAAG,CAAC,CAAC,YAAY,GAChC,OAAO;GAAE,IAAI;GAAO,MAAM;GAAe,SAAS,QAAQ,IAAI;EAAuB;CAEzF,SAAS,OAAO;EAEd,OAAO;GAAE,IAAI;GAAO,MAAM;GAAe,SAAS,QAAQ,IAAI,uBAD/C,iBAAiB,QAAQ,IAAI,MAAM,YAAY;EACgC;CAChG;CAEA,MAAM,QAAQ,IAAIC,uBAAAA,sBAAsB,CAAC,CAAC,KAAK,KAAK,MAAM,cAAc,QAAQ,MAAM,KAAK;CAC3F,IAAI,CAAC,OAAO,OAAO;EAAE,IAAI;EAAO,MAAM;EAAiB,SAAS,kBAAkB,MAAM;CAAQ;CAEhG,OAAO;EACL,IAAI;EACJ,UAAU;GAAE;GAAO;GAAK,SAAS,MAAM,WAAW,MAAM,kBAAkB;EAAQ;CACpF;AACF"}

package/dist/index.d.mts

@@ -0,0 +1,160 @@
+//#region src/types/index.d.ts
+/** Whether an agent's prompt extends the host's system prompt or replaces it. */
+type SystemPromptMode = 'append' | 'replace';
+/**
+ * A ceiling on how many tool calls a child may make.
+ *
+ * `soft` nudges, `hard` blocks. `block` narrows enforcement to named tools, or
+ * `'*'` for all of them.
+ */
+interface ToolBudgetConfig {
+  soft?: number;
+  hard: number;
+  block?: string[] | '*';
+}
+//#endregion
+//#region src/types/agent.d.ts
+/** Which directories a discovery pass should read. */
+type AgentScope = 'user' | 'project' | 'both';
+/**
+ * Where an agent definition came from.
+ *
+ * The order matters: a project agent shadows a user agent of the same name,
+ * which in turn shadows one staged by a plugin.
+ */
+type AgentSource = 'plugin' | 'user' | 'project';
+/** Whether a child starts from a clean context or forks the parent's. */
+type AgentDefaultContext = 'fresh' | 'fork';
+type AgentMemoryScope = 'project' | 'user';
+interface AgentMemoryConfig {
+  enabled?: boolean;
+  scope?: AgentMemoryScope;
+  maxEntries?: number;
+}
+/** Records that a model came from a settings default rather than frontmatter. */
+interface AgentModelSourceInfo {
+  type: 'subagents.defaultModel' | 'packages.team.defaultModel';
+  scope: 'user' | 'project' | 'package';
+  path: string;
+  model: string;
+}
+/**
+ * The frontmatter fields a builtin agent's override may restate.
+ *
+ * Overriding a builtin captures the original values so the override can be
+ * removed later and the builtin restored exactly, which is why this is a
+ * snapshot rather than a diff.
+ */
+interface BuiltinAgentOverrideBase {
+  description?: string;
+  tools?: string[];
+  model?: string;
+  fallbackModels?: string[];
+  thinking?: string | false;
+  systemPromptMode?: SystemPromptMode;
+  inheritProjectContext?: boolean;
+  inheritSkills?: boolean;
+  skills?: string[];
+  skillPath?: string[];
+  extensions?: string[];
+  subagentOnlyExtensions?: string[];
+  output?: string;
+  defaultReads?: string[];
+  defaultProgress?: boolean;
+  defaultContext?: AgentDefaultContext;
+  defaultTimeoutMs?: number;
+  /** Which runtime executes this agent. Defaults to the in-process `pi` SDK path. */
+  runtime?: string;
+  interactive?: boolean;
+  maxSubagentDepth?: number;
+  completionGuard?: boolean;
+  toolBudget?: ToolBudgetConfig;
+  memory?: AgentMemoryConfig;
+  systemPrompt?: string;
+  disabled?: boolean;
+}
+/** Which settings file overrode a builtin, and what it looked like before. */
+interface BuiltinAgentOverrideInfo {
+  scope: 'user' | 'project';
+  path: string;
+  base: BuiltinAgentOverrideBase;
+}
+/**
+ * A fully resolved agent definition.
+ *
+ * Resolved means frontmatter has been merged with settings defaults and any
+ * builtin override, so consumers never re-apply precedence themselves.
+ */
+interface AgentConfig {
+  name: string;
+  /** Unqualified name, when the agent is namespaced by a package. */
+  localName?: string;
+  packageName?: string;
+  description: string;
+  tools?: string[];
+  mcpDirectTools?: string[];
+  model?: string;
+  fallbackModels?: string[];
+  thinking?: string | false;
+  systemPromptMode: SystemPromptMode;
+  inheritProjectContext: boolean;
+  /** Controls Pi ambient skill discovery only; explicit named `skills` remain available. */
+  inheritSkills: boolean;
+  defaultContext?: AgentDefaultContext;
+  defaultTimeoutMs?: number;
+  /** Which runtime executes this agent. Defaults to the in-process `pi` SDK path. */
+  runtime?: string;
+  systemPrompt: string;
+  source: AgentSource;
+  filePath: string;
+  /** Explicit named skill requirements projected into Pi child prompts. */
+  skills?: string[];
+  /** Lookup roots for explicit skill names; relative roots resolve from the request cwd. */
+  skillPath?: string[];
+  extensions?: string[];
+  /** True when `extensions` came from a settings default, not from frontmatter. */
+  extensionsFromDefault?: boolean;
+  subagentOnlyExtensions?: string[];
+  output?: string;
+  defaultReads?: string[];
+  defaultProgress?: boolean;
+  interactive?: boolean;
+  maxSubagentDepth?: number;
+  completionGuard?: boolean;
+  toolBudget?: ToolBudgetConfig;
+  memory?: AgentMemoryConfig;
+  disabled?: boolean;
+  /** Frontmatter keys this package does not interpret, preserved for round-tripping. */
+  extraFields?: Record<string, string>;
+  override?: BuiltinAgentOverrideInfo;
+  modelSource?: AgentModelSourceInfo;
+}
+//#endregion
+//#region src/services/subagentLaunchContract/index.d.ts
+interface SubagentLaunchContractInput {
+  agent: string;
+  cwd: string;
+  task?: string;
+  agentScope?: AgentScope;
+  context?: 'fresh' | 'fork';
+  skill?: string | string[] | boolean;
+  artifacts?: boolean;
+}
+interface SubagentLaunchContract {
+  agent: AgentConfig;
+  cwd: string;
+  context: 'fresh' | 'fork';
+}
+type SubagentLaunchContractResult = {
+  ok: true;
+  contract: SubagentLaunchContract;
+} | {
+  ok: false;
+  code: 'invalid_cwd' | 'missing_agent';
+  message: string;
+};
+/** Lightweight public availability check using Doom Team's discovery rules. */
+export declare function resolveSubagentLaunchContract(input: SubagentLaunchContractInput): Promise<SubagentLaunchContractResult>;
+//#endregion
+export type { SubagentLaunchContract, SubagentLaunchContractInput, SubagentLaunchContractResult };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/index.ts","../src/types/agent.ts","../src/services/subagentLaunchContract/index.ts"],"mappings":";;KAyGY;;;;;;;UA4CK;EACf;EACA;EACA;;;;;KCrIU;;;;;;;KAQA;;KAGA;KASA;UAEK;EACf;EACA,QAAQ;EACR;;;UAIe;EACf;EACA;EACA;EACA;;;;;;;;;UAUe;EACf;EACA;EACA;EACA;EACA;EACA,mBAAmB;EACnB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,iBAAiB;EACjB;;EAEA;EACA;EACA;EACA;EACA,aAAa;EACb,SAAS;EACT;EACA;;;UAsCe;EACf;EACA;EACA,MAAM;;;;;;;;UASS;EACf;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,kBAAkB;EAClB;;EAEA;EACA,iBAAiB;EACjB;;EAEA;EACA;EACA,QAAQ;EACR;;EAEA;;EAEA;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,aAAa;EACb,SAAS;EACT;;EAEA,cAAc;EACd,WAAW;EACX,cAAc;;;;UCxKC;EACf;EACA;EACA;EACA,aAAa;EACb;EACA;EACA;;UAGe;EACf,OAAO;EACP;EACA;;KAGU;EACN;EAAU,UAAU;;EACpB;EAAW;EAAuC;;;wBAGlC,8BACpB,OAAO,8BACN,QAAQ"}

package/dist/index.mjs

@@ -0,0 +1,45 @@
+import { t as AgentDiscoveryService } from "./agentDiscovery-ZQlFkKvB.mjs";
+import * as fs from "node:fs";
+import * as path from "node:path";
+//#region src/services/subagentLaunchContract/index.ts
+/**
+* Public availability check for a subagent launch.
+*
+* Lives in adapters rather than services: resolving the contract stats the
+* working directory and reads agent definitions off disk.
+*/
+/** Lightweight public availability check using Doom Team's discovery rules. */
+async function resolveSubagentLaunchContract(input) {
+	const cwd = path.resolve(input.cwd);
+	try {
+		if (!fs.statSync(cwd).isDirectory()) return {
+			ok: false,
+			code: "invalid_cwd",
+			message: `cwd '${cwd}' is not a directory.`
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			code: "invalid_cwd",
+			message: `cwd '${cwd}' is not a directory.${error instanceof Error ? ` ${error.message}` : ""}`
+		};
+	}
+	const agent = new AgentDiscoveryService().find(cwd, input.agentScope ?? "both", input.agent);
+	if (!agent) return {
+		ok: false,
+		code: "missing_agent",
+		message: `Unknown agent: ${input.agent}`
+	};
+	return {
+		ok: true,
+		contract: {
+			agent,
+			cwd,
+			context: input.context ?? agent.defaultContext ?? "fresh"
+		}
+	};
+}
+//#endregion
+export { resolveSubagentLaunchContract };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/services/subagentLaunchContract/index.ts"],"sourcesContent":["/**\n * Public availability check for a subagent launch.\n *\n * Lives in adapters rather than services: resolving the contract stats the\n * working directory and reads agent definitions off disk.\n */\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\nimport type { AgentConfig, AgentScope } from '../../types/agent';\nimport { AgentDiscoveryService } from '../agentDiscovery';\n\nexport interface SubagentLaunchContractInput {\n  agent: string;\n  cwd: string;\n  task?: string;\n  agentScope?: AgentScope;\n  context?: 'fresh' | 'fork';\n  skill?: string | string[] | boolean;\n  artifacts?: boolean;\n}\n\nexport interface SubagentLaunchContract {\n  agent: AgentConfig;\n  cwd: string;\n  context: 'fresh' | 'fork';\n}\n\nexport type SubagentLaunchContractResult =\n  | { ok: true; contract: SubagentLaunchContract }\n  | { ok: false; code: 'invalid_cwd' | 'missing_agent'; message: string };\n\n/** Lightweight public availability check using Doom Team's discovery rules. */\nexport async function resolveSubagentLaunchContract(\n  input: SubagentLaunchContractInput,\n): Promise<SubagentLaunchContractResult> {\n  const cwd = path.resolve(input.cwd);\n  try {\n    if (!fs.statSync(cwd).isDirectory()) {\n      return { ok: false, code: 'invalid_cwd', message: `cwd '${cwd}' is not a directory.` };\n    }\n  } catch (error) {\n    const detail = error instanceof Error ? ` ${error.message}` : '';\n    return { ok: false, code: 'invalid_cwd', message: `cwd '${cwd}' is not a directory.${detail}` };\n  }\n\n  const agent = new AgentDiscoveryService().find(cwd, input.agentScope ?? 'both', input.agent);\n  if (!agent) return { ok: false, code: 'missing_agent', message: `Unknown agent: ${input.agent}` };\n\n  return {\n    ok: true,\n    contract: { agent, cwd, context: input.context ?? agent.defaultContext ?? 'fresh' },\n  };\n}\n"],"mappings":";;;;;;;;;;;AAiCA,eAAsB,8BACpB,OACuC;CACvC,MAAM,MAAM,KAAK,QAAQ,MAAM,GAAG;CAClC,IAAI;EACF,IAAI,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,YAAY,GAChC,OAAO;GAAE,IAAI;GAAO,MAAM;GAAe,SAAS,QAAQ,IAAI;EAAuB;CAEzF,SAAS,OAAO;EAEd,OAAO;GAAE,IAAI;GAAO,MAAM;GAAe,SAAS,QAAQ,IAAI,uBAD/C,iBAAiB,QAAQ,IAAI,MAAM,YAAY;EACgC;CAChG;CAEA,MAAM,QAAQ,IAAI,sBAAsB,CAAC,CAAC,KAAK,KAAK,MAAM,cAAc,QAAQ,MAAM,KAAK;CAC3F,IAAI,CAAC,OAAO,OAAO;EAAE,IAAI;EAAO,MAAM;EAAiB,SAAS,kBAAkB,MAAM;CAAQ;CAEhG,OAAO;EACL,IAAI;EACJ,UAAU;GAAE;GAAO;GAAK,SAAS,MAAM,WAAW,MAAM,kBAAkB;EAAQ;CACpF;AACF"}