@agimon-ai/po-team 0.0.0-alpha.28 → 0.0.0-alpha.29

package/README.md

@@ -110,6 +110,14 @@ final model and tools. A child cannot exceed the capability ceiling supplied by
 provider policy. Allowed MCP and stdio tools can execute commands, so treat agent definitions and
 the inherited environment as trusted configuration.
 
+A subagent borrows its parent's Po tools, code mode (`discover` and `exec`) and skill loading included,
+beside Pi's coding tools and any MCP tools it is granted. It does not get a tool that needs the person to
+answer (`ask_user_question`, `write_plan`, `complete_plan`), since nobody can answer a subagent, nor
+`subagent` and `intercom`, which act for the main agent; a tool opts out with `mainAgentOnly`. A subagent
+is never given a tool its parent is denied: while the parent is planning, `edit` and `write` are withheld
+from both. An agent file that lists `tools` gets only those. Code-mode runs share the session's namespaces,
+so a subagent and its parent see the same browser pages and task graph.
+
 ## Task delegation bridge
 
 With Task installed:
@@ -153,3 +161,13 @@ Business Source License 1.1: free for personal use, organisations under USD 1M r
 ## Source and lifecycle
 
 The routed files own contribution registration. Team's collaboration service replaces session fibers explicitly, uses the injected session only when its session manager matches, and otherwise mounts in the standalone plugin context. Losing that injected session disposes its collaboration fiber.
+
+## Read-only code-mode state
+
+When code mode is loaded, `team.members()` returns native members of this session
+(not peer sessions), and `team.runs()` returns tracked runs. Use JavaScript to filter
+these detached snapshots, for example `team.runs().find(run => run.runId === id)`.
+Finished runs drop off 10 minutes after acknowledgement. Run projections exclude
+paths and delegation prompts, and member snapshots exclude capability tokens.
+Usage token counts remain available as `tokens` on runs. No writer members are
+exposed. Direct `subagent` and `intercom` tools remain available and unchanged.

package/dist/extensions/server.cjs

@@ -27,6 +27,7 @@ let _agimon_ai_po_core_extensionFile = require("@agimon-ai/po-core/extensionFile
 let _agimon_ai_po_config = require("@agimon-ai/po-config");
 let _agimon_ai_po_core_backgroundWork = require("@agimon-ai/po-core/backgroundWork");
 let _agimon_ai_po_core_childSession = require("@agimon-ai/po-core/childSession");
+let _agimon_ai_po_core_codemode = require("@agimon-ai/po-core/codemode");
 let _agimon_ai_po_core_contextContributions = require("@agimon-ai/po-core/contextContributions");
 let _agimon_ai_po_core_mcpToolResolver = require("@agimon-ai/po-core/mcpToolResolver");
 let _agimon_ai_po_session = require("@agimon-ai/po-session");
@@ -3795,6 +3796,7 @@ function createHeadlessIntercomTool(channel, sessions) {
 	return {
 		name: "intercom",
 		label: "Intercom",
+		mainAgentOnly: true,
 		description: "Communicate with active agents and related live sessions.",
 		parameters: TeamToolParamsSchema,
 		promptGuidelines: ["Send only new progress, blockers, or decisions. Do not repeat task briefs or delegation instructions.", "Use members to find related sessions by the names people give them, then send to that name or its session ID. Session peers use send, not ask/reply, and can send back."],
@@ -4888,6 +4890,7 @@ function createHeadlessSubagentTool(runtime, initialExecution) {
 	return {
 		name: "subagent",
 		label: "Subagent",
+		mainAgentOnly: true,
 		description: SUBAGENT_DESCRIPTION,
 		parameters: require_subagentTool.SubagentToolSchema,
 		promptSnippet: "Discover, run, inspect, steer, and stop persistent subagents",
@@ -5690,6 +5693,92 @@ function teamCollaborationPlugin(ctx, config) {
 	}, "@agimon-ai/po-team/collaboration");
 }
 //#endregion
+//#region src/services/teamNamespace/index.ts
+const DECLARATIONS = `interface TeamMember {
+  name: string;
+  role: 'main' | 'subagent';
+  agent?: string;
+  inline?: boolean;
+  runId?: string;
+  task?: { id: string; subject: string };
+}
+interface TeamRun {
+  runId: string;
+  agent?: string;
+  identity?: string;
+  status: string | undefined;
+  startedAt?: number;
+  updatedAt?: number;
+  activityState?: 'starting' | 'working' | 'tool' | 'waiting_for_reply' | 'needs_attention' | 'finalizing' | 'active_long_running';
+  attentionReason?: string;
+  runtime?: string;
+  native?: boolean;
+  summary?: string;
+  error?: string;
+  tokens?: number;
+  cost?: number;
+  currentTool?: string;
+  toolCount?: number;
+}
+declare const team: {
+  /** Native team members in this session, not peer sessions. */
+  members(): TeamMember[];
+  /** Tracked runs. Finished runs drop off 10 minutes after acknowledgement. */
+  runs(): TeamRun[];
+};`;
+/** Session-owned read-only state. Direct tools retain all mutation capabilities. */
+function createTeamNamespace(options) {
+	return {
+		name: "team",
+		summary: "Read native team members and tracked runs in this session with team.members() and team.runs().",
+		declarations: DECLARATIONS,
+		bind(run) {
+			if (run.sessionId !== options.sessionId) throw new Error("Team namespace belongs to another session.");
+			let disposed = false;
+			run.onDispose(() => {
+				disposed = true;
+			});
+			const check = () => {
+				run.signal.throwIfAborted();
+				if (disposed) throw new Error("Team code-mode run is disposed.");
+				options.assertAvailable();
+			};
+			const members = Object.create(null);
+			members.members = () => {
+				check();
+				const snapshot = JSON.parse(JSON.stringify(require_teamSnapshot.readActiveTeamSnapshot(options.channel)?.members ?? []));
+				check();
+				return snapshot;
+			};
+			members.runs = () => {
+				check();
+				const runs = options.jobs.list().map((job) => ({
+					runId: job.runId,
+					agent: job.agent,
+					identity: job.identity,
+					status: job.status,
+					startedAt: job.startedAt,
+					updatedAt: job.updatedAt,
+					activityState: job.activityState,
+					attentionReason: job.attentionReason,
+					runtime: job.runtime,
+					native: job.native,
+					summary: job.summary,
+					error: job.error,
+					tokens: job.tokens,
+					cost: job.cost,
+					currentTool: job.currentTool,
+					toolCount: job.toolCount
+				}));
+				const snapshot = JSON.parse(JSON.stringify(runs));
+				check();
+				return snapshot;
+			};
+			return members;
+		}
+	};
+}
+//#endregion
 //#region src/services/managementActions/index.ts
 /**
 * Session-scoped management over in-memory run projections and typed controls.
@@ -6598,6 +6687,17 @@ const root = (0, _agimon_ai_po_core_extensionFile.defineRoot)(({ context, host:
 				policies: runtime.capabilityPolicies,
 				observeDelegation: (observation) => recordDelegationObservation(telemetry, observation)
 			});
+			providerContext.inject([_agimon_ai_po_core_codemode.PO_CODEMODE_SERVICE], (scoped) => {
+				const registration = (0, _agimon_ai_po_core_codemode.readPoCodemode)(scoped)?.register("@agimon-ai/po-team", createTeamNamespace({
+					sessionId: execution.sessionId,
+					channel,
+					jobs,
+					assertAvailable: () => {
+						if (disposing) throw new Error("Team session is disposing.");
+					}
+				}));
+				return () => registration?.dispose();
+			});
 			providerContext.inject([_agimon_ai_po_config.PO_CONFIG_SERVICE], (configContext) => {
 				const config = configContext.get(_agimon_ai_po_config.PO_CONFIG_SERVICE);
 				if (!config) throw new Error("Team requires the session Po config service.");
@@ -7069,6 +7169,15 @@ var sessionStart_server_default = (0, _agimon_ai_po_core_extensionFile.defineHoo
 	handle: () => root.restoreRuns()
 }));
 //#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/po-use-team.server.ts
+var po_use_team_server_default = (0, _agimon_ai_po_core_extensionFile.defineResource)({
+	name: "po-use-team",
+	description: "Use @agimon-ai/po-team: see which native team members and tracked subagent runs this session has, and read their state in code mode before deciding to wait, steer, or stop a run.",
+	kind: "skill",
+	path: (0, _agimon_ai_po_core_serverPlugin.packageResourcePath)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-team/SKILL.md"),
+	read: () => (0, _agimon_ai_po_core_serverPlugin.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-team/SKILL.md")
+});
+//#endregion
 //#region src/extensions/workspaces/sessions/(backend)/resource/_lib/team.server.ts
 /**
 * The roster the model is allowed to see.
@@ -7109,11 +7218,11 @@ const serverPlugin = (0, _agimon_ai_po_core_serverPlugin.defineServerPlugin)({
 	name: "@agimon-ai/po-team",
 	providerOverrides: (0, _agimon_ai_po_core_serverPlugin.composeServerProviderOverrides)(root_server_default),
 	injects: (0, _agimon_ai_po_core_extensionFile.composeRootInjects)({ session: [root_server_default] }),
-	global: () => ({ get channels() {
-		return [() => via({ frameType: "subagent_catalog" }, subagent_catalog_server_default()), () => via({ frameType: "subagent_runs" }, subagent_runs_server_default())];
+	global: (context) => ({ get channels() {
+		return [() => via({ frameType: "subagent_catalog" }, at(subagent_catalog_server_default, context)), () => via({ frameType: "subagent_runs" }, at(subagent_runs_server_default, context))];
 	} }),
 	workspace: (context) => ({ get channels() {
-		return defined([context.hosted("global") ? void 0 : () => via({ frameType: "subagent_catalog" }, subagent_catalog_server_default()), context.hosted("global") ? void 0 : () => via({ frameType: "subagent_runs" }, subagent_runs_server_default())]);
+		return defined([context.hosted("global") ? void 0 : () => via({ frameType: "subagent_catalog" }, at(subagent_catalog_server_default, context)), context.hosted("global") ? void 0 : () => via({ frameType: "subagent_runs" }, at(subagent_runs_server_default, context))]);
 	} }),
 	session: async (context) => {
 		const scopeSession = await context.scopeRoot("session", root_server_default, context);
@@ -7127,13 +7236,13 @@ const serverPlugin = (0, _agimon_ai_po_core_serverPlugin.defineServerPlugin)({
 				return [at(route_server_default, contextSession)];
 			},
 			get channels() {
-				return defined([context.hosted("global") ? void 0 : () => via({ frameType: "subagent_catalog" }, subagent_catalog_server_default()), context.hosted("global") ? void 0 : () => via({ frameType: "subagent_runs" }, subagent_runs_server_default())]);
+				return defined([context.hosted("global") ? void 0 : () => via({ frameType: "subagent_catalog" }, at(subagent_catalog_server_default, context)), context.hosted("global") ? void 0 : () => via({ frameType: "subagent_runs" }, at(subagent_runs_server_default, context))]);
 			},
 			get hooks() {
 				return [via({ event: "session_start" }, at(sessionStart_server_default, contextSession))];
 			},
 			get resources() {
-				return [at(team_server_default, contextSession)];
+				return [at(po_use_team_server_default, contextSession), at(team_server_default, contextSession)];
 			},
 			get tools() {
 				return [via({ name: "intercom" }, at(intercom_server_default, contextSession)), via({ name: "subagent" }, at(subagent_server_default, contextSession))];