@oai404iao/pi-subagent 0.2.0

package/src/types.ts

@@ -0,0 +1,154 @@
+import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
+import type { Usage } from "@earendil-works/pi-ai";
+
+export type AgentScope = "user" | "project" | "both";
+export type AgentSource = "bundled" | "user" | "project";
+export type ReportDelivery = "wakeup" | "quiet";
+export type SubagentMode = "one-shot" | "continuable";
+export type SubagentProviderName = "spawn" | "fork";
+export type SubagentStopReason = "completed" | "aborted" | "error" | "max-tokens";
+
+export interface SubagentSettings {
+	agentScope: AgentScope;
+	syncBundledAgents: boolean;
+	maxDepth: number;
+	enableRunInBackground: boolean;
+	defaultBackground: boolean;
+	reportDelivery: ReportDelivery;
+	inheritExtensions: boolean;
+	maxOutputBytes: number;
+}
+
+export interface AgentDefinition {
+	name: string;
+	description: string;
+	tools?: string[];
+	model?: string;
+	thinking?: ThinkingLevel;
+	systemPrompt: string;
+	source: AgentSource;
+	filePath: string;
+}
+
+export interface AgentSnapshot {
+	name: string;
+	description: string;
+	tools?: string[];
+	model?: string;
+	thinking?: ThinkingLevel;
+	systemPrompt: string;
+	source: AgentSource;
+}
+
+export interface ResolvedModel {
+	provider: string;
+	id: string;
+}
+
+export interface SubagentRuntimeSnapshot {
+	agentScope: AgentScope;
+	syncBundledAgents: boolean;
+	maxDepth: number;
+	enableRunInBackground: boolean;
+	defaultBackground: boolean;
+	reportDelivery: ReportDelivery;
+	inheritExtensions: boolean;
+	maxOutputBytes: number;
+}
+
+export interface SubagentDescriptor {
+	version: 1;
+	mode: SubagentMode;
+	provider: SubagentProviderName;
+	label: string;
+	parentSessionId: string;
+	parentSessionFile?: string;
+	depth: number;
+	cwd: string;
+	createdAt: string;
+	agent: AgentSnapshot;
+	model: ResolvedModel;
+	thinkingLevel: ThinkingLevel;
+	runtime: SubagentRuntimeSnapshot;
+}
+
+export interface SubagentUsage extends Usage {
+	turns: number;
+}
+
+export interface SubagentRunResult {
+	id: string;
+	sessionFile?: string;
+	output: string;
+	stopReason: SubagentStopReason;
+	usage: SubagentUsage;
+}
+
+export interface TraceItem {
+	type: "tool" | "text";
+	name?: string;
+	text: string;
+}
+
+export interface DelegationDetails {
+	kind: "delegation";
+	id: string;
+	provider: SubagentProviderName;
+	mode: SubagentMode;
+	agent: string;
+	label: string;
+	depth: number;
+	status: "starting" | "running" | "waiting" | "completed" | "failed" | "ready";
+	sessionFile?: string;
+	stopReason?: SubagentStopReason;
+	output?: string;
+	trace: TraceItem[];
+	usage?: SubagentUsage;
+}
+
+export interface ControlDetails {
+	kind: "control";
+	action: "send" | "interrupt" | "list" | "report";
+	id?: string;
+}
+
+export interface CatalogChild {
+	kind: "child";
+	id: string;
+	parentId: string;
+	depth: number;
+	descriptor: SubagentDescriptor;
+	sessionFile?: string;
+	status: "running" | "idle" | "ready";
+}
+
+export interface CatalogDiagnostic {
+	kind: "diagnostic";
+	id: string;
+	reason: "corrupt" | "unavailable";
+	sessionFile?: string;
+	parentSessionFile?: string;
+	message: string;
+}
+
+export type CatalogEntry = CatalogChild | CatalogDiagnostic;
+
+export interface ParentMessageDetails {
+	kind: "report" | "settled";
+	childId: string;
+	label: string;
+	stopReason?: SubagentStopReason;
+	truncated?: boolean;
+}
+
+export function snapshotAgent(agent: AgentDefinition): AgentSnapshot {
+	return {
+		name: agent.name,
+		description: agent.description,
+		...(agent.tools ? { tools: [...agent.tools] } : {}),
+		...(agent.model ? { model: agent.model } : {}),
+		...(agent.thinking ? { thinking: agent.thinking } : {}),
+		systemPrompt: agent.systemPrompt,
+		source: agent.source,
+	};
+}