p-spore 0.1.0

package/dist/agents/agent-tools.js

@@ -0,0 +1,111 @@
+import { defineTool } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+const budget = Type.Object({
+    maxTurns: Type.Integer({ minimum: 1, maximum: 10_000 }),
+    maxToolCalls: Type.Integer({ minimum: 1, maximum: 100_000 }),
+    maxInputTokens: Type.Integer({ minimum: 1, maximum: 100_000_000 }),
+    maxOutputTokens: Type.Integer({ minimum: 1, maximum: 100_000_000 }),
+    maxChildren: Type.Integer({ minimum: 0, maximum: 1_000 }),
+    maxCostUsd: Type.Optional(Type.Number({ exclusiveMinimum: 0 })),
+}, { additionalProperties: false });
+const spawnParameters = Type.Object({
+    objective: Type.String({ minLength: 1, maxLength: 8_000 }),
+    cwd: Type.String({ minLength: 1, maxLength: 4_096 }),
+    workspaceMode: Type.Union([Type.Literal("shared-read"), Type.Literal("shared-write")]),
+    budget,
+}, { additionalProperties: false });
+const sendParameters = Type.Object({
+    agentId: Type.String({ minLength: 1, maxLength: 128 }),
+    message: Type.String({ minLength: 1, maxLength: 8_000 }),
+    mode: Type.Union([Type.Literal("steer"), Type.Literal("follow_up"), Type.Literal("next")]),
+}, { additionalProperties: false });
+const joinParameters = Type.Object({
+    agentIds: Type.Array(Type.String({ minLength: 1, maxLength: 128 }), { minItems: 1, maxItems: 32 }),
+    timeoutMs: Type.Integer({ minimum: 1, maximum: 600_000 }),
+}, { additionalProperties: false });
+const cancelParameters = Type.Object({
+    agentId: Type.String({ minLength: 1, maxLength: 128 }),
+    reason: Type.Optional(Type.String({ minLength: 1, maxLength: 1_000 })),
+}, { additionalProperties: false });
+export function createAgentTools(sessionId, manager) {
+    const spawn = defineTool({
+        name: "agent_spawn",
+        label: "Spawn Agent",
+        description: "Create a bounded child agent and return immediately. Delegate a finite objective and explicit budget.",
+        parameters: spawnParameters,
+        executionMode: "sequential",
+        execute: async (_toolCallId, params, signal) => {
+            throwIfAborted(signal);
+            const agents = manager();
+            const agent = await agents.spawn({
+                parentId: agents.parentIdForSession(sessionId),
+                objective: params.objective,
+                cwd: params.cwd,
+                workspaceMode: params.workspaceMode,
+                budget: params.budget,
+            });
+            return { content: [{ type: "text", text: JSON.stringify(agent, null, 2) }], details: { agent } };
+        },
+    });
+    const send = defineTool({
+        name: "agent_send",
+        label: "Send Agent Message",
+        description: "Send steer/follow-up/next input to a direct child, or use agentId=parent from a child.",
+        parameters: sendParameters,
+        executionMode: "sequential",
+        execute: async (_toolCallId, params, signal) => {
+            throwIfAborted(signal);
+            const agents = manager();
+            const message = await agents.send({
+                senderId: agents.parentIdForSession(sessionId),
+                recipientId: params.agentId,
+                text: params.message,
+                mode: params.mode,
+            });
+            return { content: [{ type: "text", text: JSON.stringify(message, null, 2) }], details: { message } };
+        },
+    });
+    const join = defineTool({
+        name: "agent_join",
+        label: "Join Agents",
+        description: "Wait for direct child agents and return their bounded structured results, without copying full transcripts.",
+        parameters: joinParameters,
+        executionMode: "sequential",
+        execute: async (_toolCallId, params, signal) => {
+            throwIfAborted(signal);
+            const agents = manager();
+            const parentId = agents.parentIdForSession(sessionId);
+            const records = agents.list();
+            for (const id of params.agentIds) {
+                if (records.find((record) => record.id === id)?.parentId !== parentId) {
+                    throw new Error(`Agent ${id} is not a direct child of ${parentId}`);
+                }
+            }
+            const joined = await agents.join(params.agentIds, params.timeoutMs, signal);
+            return { content: [{ type: "text", text: JSON.stringify(joined, null, 2) }], details: { agents: joined } };
+        },
+    });
+    const cancel = defineTool({
+        name: "agent_cancel",
+        label: "Cancel Agent",
+        description: "Cancel a direct child agent and cascade cancellation to its descendants.",
+        parameters: cancelParameters,
+        executionMode: "sequential",
+        execute: async (_toolCallId, params, signal) => {
+            throwIfAborted(signal);
+            const agents = manager();
+            const parentId = agents.parentIdForSession(sessionId);
+            if (agents.list().find((record) => record.id === params.agentId)?.parentId !== parentId) {
+                throw new Error(`Agent ${params.agentId} is not a direct child of ${parentId}`);
+            }
+            const agent = await agents.cancel(params.agentId, params.reason ?? `cancelled by parent ${parentId}`);
+            return { content: [{ type: "text", text: JSON.stringify(agent, null, 2) }], details: { agent } };
+        },
+    });
+    return [spawn, send, join, cancel];
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw signal.reason instanceof Error ? signal.reason : new Error("Agent tool aborted");
+}
+//# sourceMappingURL=agent-tools.js.map

package/dist/agents/agent-tools.js.map

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

package/dist/agents/types.d.ts

@@ -0,0 +1,52 @@
+import type { RunBudget } from "../automation/types.js";
+import type { RuntimeUsage } from "../domain/runtime.js";
+export type AgentStatus = "queued" | "running" | "succeeded" | "failed" | "cancelled" | "budget_exhausted";
+export type AgentWorkspaceMode = "shared-read" | "shared-write";
+export type AgentMessageMode = "steer" | "follow_up" | "next";
+export interface AgentResult {
+    status: Extract<AgentStatus, "succeeded" | "failed" | "cancelled" | "budget_exhausted">;
+    summary: string;
+    evidenceRefs: string[];
+    changedFiles: string[];
+    openQuestions: string[];
+    usage: RuntimeUsage;
+}
+export interface AgentRecord {
+    version: 1;
+    id: string;
+    sessionId: string;
+    parentId: string;
+    rootId: string;
+    objective: string;
+    cwd: string;
+    depth: number;
+    workspaceMode: AgentWorkspaceMode;
+    budget: RunBudget;
+    status: AgentStatus;
+    createdAt: string;
+    startedAt?: string;
+    finishedAt?: string;
+    result?: AgentResult;
+    error?: string;
+}
+export interface AgentMessage {
+    version: 1;
+    id: string;
+    senderId: string;
+    recipientId: string;
+    sequence: number;
+    correlationId: string;
+    priority: "normal" | "high";
+    mode: AgentMessageMode;
+    text: string;
+    tokenEstimate: number;
+    ts: string;
+}
+export interface AgentSpawnRequest {
+    parentId: string;
+    objective: string;
+    cwd: string;
+    workspaceMode: AgentWorkspaceMode;
+    budget: RunBudget;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,kBAAkB,CAAC;AAC3G,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,cAAc,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,kBAAkB,CAAC,CAAC;IACxF,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,kBAAkB,CAAC;IAClC,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,kBAAkB,CAAC;IAClC,MAAM,EAAE,SAAS,CAAC;CACnB"}

package/dist/agents/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":""}

package/dist/application/agent-application.d.ts

@@ -0,0 +1,89 @@
+import type { AgentSessionHost } from "../agents/agent-manager.js";
+import type { AgentMessage, AgentMessageMode, AgentRecord, AgentSpawnRequest } from "../agents/types.js";
+import type { JobDefinition, RunBudget, RunRecord } from "../automation/types.js";
+import type { AgentRuntimePort, AgentSessionSpec, AgentSnapshot, RuntimeEvent } from "../domain/runtime.js";
+import type { KernelLoop } from "../kernel/loop.js";
+import type { McpHealthRecord, McpToolDescriptor } from "../mcp/types.js";
+import type { NotificationService } from "../notifications/notification-service.js";
+import type { ApprovalService } from "../policy/approval-service.js";
+import type { ResourceCatalogEntry, ResourceKind, StagedResourceInspection } from "../plugins/types.js";
+import type { CommandEnvelope } from "../protocol/schema.js";
+export interface AgentApplicationOptions {
+    runtime: AgentRuntimePort;
+    kernel: KernelLoop;
+    approvals: ApprovalService;
+    notifications: Pick<NotificationService, "list">;
+    sessionTemplate: Omit<AgentSessionSpec, "sessionId">;
+    modelConfigured: boolean;
+    onShutdownRequested?: () => void;
+    clock?: () => Date;
+    idFactory?: () => string;
+}
+export interface AutomationControl {
+    listJobs(): JobDefinition[];
+    listRuns(): RunRecord[];
+    putJob(value: unknown, expectedSha256: string | null): Promise<JobDefinition>;
+    triggerJob(jobId: string, scheduledFor: Date, source: "user"): Promise<RunRecord>;
+    cancel(runId: string, reason?: string): Promise<RunRecord>;
+}
+export interface AgentControl {
+    registerRoot(input: {
+        id: string;
+        budget: RunBudget;
+        jobId?: string;
+        agentPath?: readonly string[];
+    }): void;
+    unregisterRoot(id: string): void;
+    parentIdForSession(sessionId: string): string;
+    spawn(input: AgentSpawnRequest): Promise<AgentRecord>;
+    send(input: {
+        senderId: string;
+        recipientId: string;
+        text: string;
+        mode: AgentMessageMode;
+        priority?: "normal" | "high";
+        correlationId?: string;
+    }): Promise<AgentMessage>;
+    join(agentIds: readonly string[], timeoutMs: number, signal?: AbortSignal): Promise<AgentRecord[]>;
+    cancel(agentId: string, reason?: string): Promise<AgentRecord>;
+    cancelChildren(parentId: string, reason: string): Promise<void>;
+    sessionAvailable(sessionId: string): Promise<void>;
+    list(): AgentRecord[];
+    listMessages(): AgentMessage[];
+}
+export interface McpControl {
+    listServers(): McpHealthRecord[];
+    listTools(): McpToolDescriptor[];
+    discover(serverId: string, signal?: AbortSignal): Promise<McpToolDescriptor[]>;
+    ping(serverId: string, signal?: AbortSignal): Promise<McpHealthRecord>;
+}
+export interface ResourceControl {
+    inspect(stagingPath: string): Promise<StagedResourceInspection>;
+    install(stagingPath: string, expectedDigest: string): Promise<ResourceCatalogEntry>;
+    disable(kind: ResourceKind, name: string, expectedDigest: string): Promise<ResourceCatalogEntry>;
+    list(): ResourceCatalogEntry[];
+}
+export declare class AgentRunBudgetError extends Error {
+    constructor(message: string);
+}
+export declare class AgentApplication implements AgentSessionHost {
+    #private;
+    constructor(options: AgentApplicationOptions);
+    handleCommand(command: CommandEnvelope): Promise<unknown>;
+    setAutomation(automation: AutomationControl): void;
+    setAgents(agents: AgentControl): void;
+    setMcp(mcp: McpControl): void;
+    setResources(resources: ResourceControl): void;
+    executeAgentRun(run: RunRecord, signal: AbortSignal): Promise<AgentSnapshot>;
+    createAgentSession(sessionId: string, cwd: string, authorization: NonNullable<AgentSessionSpec["authorization"]>): Promise<void>;
+    hasAgentSession(sessionId: string): boolean;
+    startAgentPrompt(sessionId: string, text: string): Promise<void>;
+    sendAgentMessage(sessionId: string, text: string, mode: AgentMessageMode): Promise<void>;
+    waitForAgentIdle(sessionId: string): Promise<void>;
+    abortAgentSession(sessionId: string, reason: string): Promise<void>;
+    snapshotAgentSession(sessionId: string): AgentSnapshot;
+    subscribeAgentSession(sessionId: string, sink: (event: RuntimeEvent) => void): () => void;
+    closeAgentSession(sessionId: string): Promise<void>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=agent-application.d.ts.map

package/dist/application/agent-application.d.ts.map

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