@grackle-ai/prompt 0.73.1

package/README.md

@@ -0,0 +1,32 @@
+# @grackle-ai/prompt
+
+System prompt assembly and persona resolution for [Grackle](https://github.com/nick-pape/grackle) agent sessions.
+
+## Overview
+
+This package prepares everything an agent session needs before it starts:
+
+- **System prompt building** — `SystemPromptBuilder` assembles prompts from discrete sections based on session type (orchestrator, leaf task, or ad-hoc). Orchestrator tasks get project context, task trees, persona rosters, and decomposition guidelines. Leaf tasks get a completion contract.
+- **Orchestrator context** — `fetchOrchestratorContext()` gathers all data needed for orchestrator prompts from the database: workspace metadata, task hierarchy, available personas/environments, and recent findings.
+- **Persona resolution** — `resolvePersona()` resolves which persona to use via a cascade: request persona → task default → workspace default → app default.
+
+## Usage
+
+```typescript
+import { SystemPromptBuilder, fetchOrchestratorContext, resolvePersona } from "@grackle-ai/prompt";
+
+// Resolve the persona for a session
+const resolved = resolvePersona(requestPersonaId, taskDefaultPersonaId, workspaceDefaultPersonaId);
+
+// Fetch orchestrator context (for orchestrator tasks)
+const context = fetchOrchestratorContext(workspaceId);
+
+// Build the system prompt
+const builder = new SystemPromptBuilder({
+  task: { title, description, notes },
+  personaPrompt: resolved.systemPrompt,
+  canDecompose: task.canDecompose,
+  ...context,
+});
+const systemPrompt = builder.build();
+```

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { SystemPromptBuilder, buildTaskPrompt } from "./system-prompt-builder.js";
+export type { SystemPromptOptions, TaskTreeNode, PersonaSummary, EnvironmentSummary } from "./system-prompt-builder.js";
+export { fetchOrchestratorContext } from "./orchestrator-context.js";
+export type { OrchestratorContext } from "./orchestrator-context.js";
+export { resolvePersona } from "./resolve-persona.js";
+export type { ResolvedPersona } from "./resolve-persona.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClF,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGxH,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// ─── System Prompt Builder ──────────────────────────────────
+export { SystemPromptBuilder, buildTaskPrompt } from "./system-prompt-builder.js";
+// ─── Orchestrator Context ───────────────────────────────────
+export { fetchOrchestratorContext } from "./orchestrator-context.js";
+// ─── Persona Resolution ────────────────────────────────────
+export { resolvePersona } from "./resolve-persona.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGlF,+DAA+D;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,8DAA8D;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/orchestrator-context.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Fetches and assembles all data needed for the orchestrator system prompt.
+ * Centralizes store reads so both gRPC and WebSocket call sites share
+ * the same data-fetching logic.
+ */
+import type { TaskTreeNode, PersonaSummary, EnvironmentSummary } from "./system-prompt-builder.js";
+/** Pre-fetched orchestrator data matching SystemPromptOptions fields. */
+export interface OrchestratorContext {
+    /** Workspace metadata (undefined when workspace not found). */
+    workspace?: {
+        name: string;
+        description: string;
+        repoUrl: string;
+    };
+    /** All tasks in the workspace mapped to tree nodes. */
+    taskTree: TaskTreeNode[];
+    /** All available personas. */
+    availablePersonas: PersonaSummary[];
+    /** All available environments. */
+    availableEnvironments: EnvironmentSummary[];
+    /** Pre-built findings context string. */
+    findingsContext: string;
+}
+/**
+ * Fetch all data needed for an orchestrator system prompt.
+ *
+ * @param workspaceId - The workspace to scope task/findings queries to.
+ * @returns Data ready to spread into SystemPromptOptions.
+ */
+export declare function fetchOrchestratorContext(workspaceId: string): OrchestratorContext | undefined;
+//# sourceMappingURL=orchestrator-context.d.ts.map

package/dist/orchestrator-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-context.d.ts","sourceRoot":"","sources":["../src/orchestrator-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGnG,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,uDAAuD;IACvD,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,8BAA8B;IAC9B,iBAAiB,EAAE,cAAc,EAAE,CAAC;IACpC,kCAAkC;IAClC,qBAAqB,EAAE,kBAAkB,EAAE,CAAC;IAC5C,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CA8D7F"}

package/dist/orchestrator-context.js

@@ -0,0 +1,90 @@
+import { taskStore, personaStore, envRegistry, findingStore, workspaceStore, safeParseJsonArray } from "@grackle-ai/database";
+/**
+ * Fetch all data needed for an orchestrator system prompt.
+ *
+ * @param workspaceId - The workspace to scope task/findings queries to.
+ * @returns Data ready to spread into SystemPromptOptions.
+ */
+export function fetchOrchestratorContext(workspaceId) {
+    // No workspace → no orchestrator context (root/System task)
+    if (!workspaceId) {
+        return undefined;
+    }
+    // Workspace metadata
+    const ws = workspaceStore.getWorkspace(workspaceId);
+    // All personas (used for both the roster and persona name resolution)
+    const allPersonas = personaStore.listPersonas();
+    const personaNameMap = new Map();
+    for (const p of allPersonas) {
+        personaNameMap.set(p.id, p.name);
+    }
+    // All tasks in this workspace → TaskTreeNode[]
+    const allTasks = taskStore.listTasks(workspaceId || undefined);
+    const taskTree = allTasks.map((t) => ({
+        id: t.id,
+        title: t.title,
+        status: t.status,
+        depth: t.depth,
+        parentTaskId: t.parentTaskId,
+        dependsOn: safeParseJsonArray(t.dependsOn),
+        personaName: personaNameMap.get(t.defaultPersonaId) || "",
+        branch: t.branch,
+        canDecompose: t.canDecompose,
+    }));
+    // Available personas
+    const availablePersonas = allPersonas.map((p) => ({
+        name: p.name,
+        description: p.description,
+        runtime: p.runtime,
+        model: p.model,
+    }));
+    // Available environments
+    const availableEnvironments = envRegistry.listEnvironments().map((e) => ({
+        displayName: e.displayName,
+        adapterType: e.adapterType,
+        status: e.status,
+        defaultRuntime: e.defaultRuntime,
+    }));
+    // Findings context (pre-formatted markdown with 8K char budget)
+    const findingsContext = workspaceId
+        ? buildFindingsContext(workspaceId)
+        : "";
+    return {
+        workspace: ws ? {
+            name: ws.name,
+            description: ws.description,
+            repoUrl: ws.repoUrl,
+        } : undefined,
+        taskTree,
+        availablePersonas,
+        availableEnvironments,
+        findingsContext,
+    };
+}
+// ─── Findings Context Builder ──────────────────────────────
+/** Maximum total characters for the findings context block. */
+const FINDINGS_MAX_CHARS = 8000;
+/** Maximum characters per individual finding's content. */
+const FINDINGS_MAX_PER_FINDING = 500;
+/** Build a summarized text context of recent findings for a workspace. */
+function buildFindingsContext(workspaceId) {
+    const allFindings = findingStore.queryFindings(workspaceId, undefined, undefined, 20);
+    if (allFindings.length === 0) {
+        return "";
+    }
+    const lines = ["## Workspace Findings (shared knowledge from other agents)\n"];
+    let totalChars = lines[0].length;
+    for (const f of allFindings) {
+        const content = f.content.length > FINDINGS_MAX_PER_FINDING
+            ? f.content.slice(0, FINDINGS_MAX_PER_FINDING) + "..."
+            : f.content;
+        const entry = `### [${f.category}] ${f.title}\n${content}\n`;
+        if (totalChars + entry.length > FINDINGS_MAX_CHARS) {
+            break;
+        }
+        lines.push(entry);
+        totalChars += entry.length;
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=orchestrator-context.js.map

package/dist/orchestrator-context.js.map

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

package/dist/resolve-persona.d.ts

@@ -0,0 +1,33 @@
+import type { PersonaRow } from "@grackle-ai/database";
+/** Resolved persona fields needed to start a session. */
+export interface ResolvedPersona {
+    /** The persona ID that was resolved. */
+    personaId: string;
+    /** Agent runtime implementation (e.g. "claude-code", "codex", "genaiscript"). */
+    runtime: string;
+    /** LLM model identifier (e.g. "sonnet", "gpt-4.1"). */
+    model: string;
+    /** Maximum turns for the agent session (0 = unlimited). */
+    maxTurns: number;
+    /** System prompt to prepend. */
+    systemPrompt: string;
+    /** JSON tool configuration. */
+    toolConfig: string;
+    /** JSON array of MCP server configs. */
+    mcpServers: string;
+    /** Persona type: "agent" (interactive LLM session) or "script" (run-to-completion). */
+    type: string;
+    /** Script source code (non-empty for script personas). */
+    script: string;
+    /** The full persona row for additional fields. */
+    persona: PersonaRow;
+}
+/**
+ * Resolve a persona using the cascade:
+ *   request persona → task default → workspace default → app default → error
+ *
+ * The first non-empty persona ID in the cascade is used to look up the persona.
+ * Throws if no persona ID is found at any level, or if the resolved ID does not exist.
+ */
+export declare function resolvePersona(requestPersonaId: string, taskDefaultPersonaId?: string, workspaceDefaultPersonaId?: string): ResolvedPersona;
+//# sourceMappingURL=resolve-persona.d.ts.map

package/dist/resolve-persona.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-persona.d.ts","sourceRoot":"","sources":["../src/resolve-persona.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,OAAO,EAAE,UAAU,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,MAAM,EACxB,oBAAoB,CAAC,EAAE,MAAM,EAC7B,yBAAyB,CAAC,EAAE,MAAM,GACjC,eAAe,CAyCjB"}

package/dist/resolve-persona.js

@@ -0,0 +1,43 @@
+import { personaStore, settingsStore } from "@grackle-ai/database";
+/**
+ * Resolve a persona using the cascade:
+ *   request persona → task default → workspace default → app default → error
+ *
+ * The first non-empty persona ID in the cascade is used to look up the persona.
+ * Throws if no persona ID is found at any level, or if the resolved ID does not exist.
+ */
+export function resolvePersona(requestPersonaId, taskDefaultPersonaId, workspaceDefaultPersonaId) {
+    const personaId = requestPersonaId ||
+        taskDefaultPersonaId ||
+        workspaceDefaultPersonaId ||
+        settingsStore.getSetting("default_persona_id") ||
+        "";
+    if (!personaId) {
+        throw new Error("No persona configured. Set a default persona at the app, workspace, or task level, or specify one explicitly.");
+    }
+    const persona = personaStore.getPersona(personaId);
+    if (!persona) {
+        throw new Error(`Persona not found: ${personaId}`);
+    }
+    const personaType = persona.type || "agent";
+    if (!persona.runtime) {
+        throw new Error(`Persona "${persona.name}" has no runtime configured`);
+    }
+    // Model is required for agent personas but optional for script personas
+    if (personaType !== "script" && !persona.model) {
+        throw new Error(`Persona "${persona.name}" has no model configured`);
+    }
+    return {
+        personaId: persona.id,
+        runtime: persona.runtime,
+        model: persona.model,
+        maxTurns: persona.maxTurns,
+        systemPrompt: persona.systemPrompt,
+        toolConfig: persona.toolConfig,
+        mcpServers: persona.mcpServers,
+        type: personaType,
+        script: persona.script,
+        persona,
+    };
+}
+//# sourceMappingURL=resolve-persona.js.map

package/dist/resolve-persona.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-persona.js","sourceRoot":"","sources":["../src/resolve-persona.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AA2BnE;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,gBAAwB,EACxB,oBAA6B,EAC7B,yBAAkC;IAElC,MAAM,SAAS,GACb,gBAAgB;QAChB,oBAAoB;QACpB,yBAAyB;QACzB,aAAa,CAAC,UAAU,CAAC,oBAAoB,CAAC;QAC9C,EAAE,CAAC;IAEL,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,+GAA+G,CAChH,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC;IAE5C,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,CAAC,IAAI,6BAA6B,CAAC,CAAC;IACzE,CAAC;IACD,wEAAwE;IACxE,IAAI,WAAW,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,CAAC,IAAI,2BAA2B,CAAC,CAAC;IACvE,CAAC;IAED,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/system-prompt-builder.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Builds system prompts for agent sessions, assembling sections
+ * dynamically based on the session type (task vs ad-hoc).
+ *
+ * Orchestrator tasks (canDecompose + depth <= 1) receive rich project
+ * context (task tree, persona roster, environments, findings).
+ * Leaf tasks receive the existing completion-contract template.
+ * Task title and description are NOT included in the system prompt — they
+ * belong in the user prompt (see {@link buildTaskPrompt}).
+ */
+/** Build the user-facing prompt from task title, description, and optional notes. */
+export declare function buildTaskPrompt(title: string, description: string, notes?: string): string;
+/** Lightweight task node for rendering the task tree in orchestrator prompts. */
+export interface TaskTreeNode {
+    /** Task ID. */
+    id: string;
+    /** Task title. */
+    title: string;
+    /** Current lifecycle status (not_started, working, paused, complete, failed). */
+    status: string;
+    /** Nesting depth in the hierarchy (0 = root). */
+    depth: number;
+    /** Parent task ID (empty string for root-level tasks). */
+    parentTaskId: string;
+    /** IDs of tasks this task depends on. */
+    dependsOn: string[];
+    /** Resolved persona display name (empty if none assigned). */
+    personaName: string;
+    /** Git branch name (empty if none). */
+    branch: string;
+    /** Whether this task can create subtasks. */
+    canDecompose: boolean;
+}
+/** Persona summary for the available-personas prompt section. */
+export interface PersonaSummary {
+    /** Display name. */
+    name: string;
+    /** Short description. */
+    description: string;
+    /** Runtime backend (claude-code, copilot, codex, etc.). */
+    runtime: string;
+    /** Default model (e.g. "opus", "sonnet"). */
+    model: string;
+}
+/** Environment summary for the available-environments prompt section. */
+export interface EnvironmentSummary {
+    /** Human-readable name. */
+    displayName: string;
+    /** Adapter backend (local, ssh, codespace, docker). */
+    adapterType: string;
+    /** Connection status (connected, disconnected, etc.). */
+    status: string;
+    /** Default runtime for this environment. */
+    defaultRuntime: string;
+}
+/** Options for building a system prompt. */
+export interface SystemPromptOptions {
+    /** Task metadata. When absent, this is an ad-hoc session. */
+    task?: {
+        title: string;
+        description: string;
+        notes: string;
+    };
+    /** ID of the current task (used to mark it in the task tree). */
+    taskId?: string;
+    /** Whether the agent is allowed to create subtasks. */
+    canDecompose?: boolean;
+    /** Persona behavioral instructions (prepended when non-empty). */
+    personaPrompt?: string;
+    /** Task depth in the hierarchy (0 = root, 1 = first child, etc.). */
+    taskDepth?: number;
+    /** Workspace metadata for the orchestrator context section. */
+    workspace?: {
+        name: string;
+        description: string;
+        repoUrl: string;
+    };
+    /** All tasks in the workspace, for rendering the task tree. */
+    taskTree?: TaskTreeNode[];
+    /** Available personas for the orchestrator to assign. */
+    availablePersonas?: PersonaSummary[];
+    /** Available environments for the orchestrator to route work to. */
+    availableEnvironments?: EnvironmentSummary[];
+    /** Pre-built findings context string (from buildFindingsContext). */
+    findingsContext?: string;
+    /** Invocation mode: fresh (first time) or resume (re-invoked after child completion). */
+    triggerMode?: "fresh" | "resume";
+}
+/**
+ * Assembles a system prompt from discrete sections based on session type.
+ *
+ * Orchestrator tasks get project state, task tree, persona roster, and
+ * decomposition guidelines. Leaf tasks get the existing completion contract.
+ * Ad-hoc sessions get only the MCP note and persona prompt.
+ * Task title and description are NOT included here — they belong in the user prompt
+ * (see {@link buildTaskPrompt}).
+ */
+export declare class SystemPromptBuilder {
+    private readonly options;
+    constructor(options: SystemPromptOptions);
+    /** Build the complete system prompt string. */
+    build(): string;
+    /**
+     * Determine whether this is an orchestrator task.
+     * Requires canDecompose, shallow depth, AND orchestrator data fields to be
+     * present. This ensures existing callers that pass canDecompose without
+     * the new fields still get the leaf template.
+     */
+    private isOrchestrator;
+    /** Orchestrator task context with role framing. */
+    private buildOrchestratorTaskContext;
+    /** Workspace metadata section. */
+    private buildWorkspaceContext;
+    /** Hierarchical task tree with statuses, personas, and dependencies. */
+    private buildTaskTree;
+    /** Available personas table. */
+    private buildAvailablePersonas;
+    /** Available environments table. */
+    private buildAvailableEnvironments;
+    /** Orchestrator findings section with actual findings data. */
+    private buildOrchestratorFindingsSection;
+    /** Trigger context describing why this invocation happened. */
+    private buildTriggerContext;
+    /** Decomposition heuristics and guardrails. */
+    private buildDecompositionGuidelines;
+    /** Orchestrator-specific MCP tool documentation. */
+    private buildOrchestratorTools;
+    /** Orchestrator-specific completion contract. */
+    private buildOrchestratorCompletionContract;
+    /** Task title, description, and notes. */
+    private buildTaskContext;
+    /** Contract for signaling task completion. */
+    private buildCompletionContract;
+    /** Subtask guidance based on canDecompose. */
+    private buildSubtaskSection;
+    /** SIGCHLD signal documentation. */
+    private buildSignalSection;
+    /** Guidance on using findings (leaf agents). */
+    private buildFindingsSection;
+    /** IPC fd cleanup instructions — advisory enforcement for closing child fds before exit. */
+    private buildIpcFdSection;
+    /** MCP note (always included). */
+    private buildMcpNote;
+}
+//# sourceMappingURL=system-prompt-builder.d.ts.map

package/dist/system-prompt-builder.d.ts.map

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

package/dist/system-prompt-builder.js

@@ -0,0 +1,323 @@
+/**
+ * Builds system prompts for agent sessions, assembling sections
+ * dynamically based on the session type (task vs ad-hoc).
+ *
+ * Orchestrator tasks (canDecompose + depth <= 1) receive rich project
+ * context (task tree, persona roster, environments, findings).
+ * Leaf tasks receive the existing completion-contract template.
+ * Task title and description are NOT included in the system prompt — they
+ * belong in the user prompt (see {@link buildTaskPrompt}).
+ */
+/** Build the user-facing prompt from task title, description, and optional notes. */
+export function buildTaskPrompt(title, description, notes) {
+    const parts = [title];
+    if (description) {
+        parts.push(description);
+    }
+    if (notes) {
+        parts.push(`## Notes\n${notes}`);
+    }
+    return parts.join("\n\n");
+}
+// ─── Builder ─────────────────────────────────────────────────
+/**
+ * Assembles a system prompt from discrete sections based on session type.
+ *
+ * Orchestrator tasks get project state, task tree, persona roster, and
+ * decomposition guidelines. Leaf tasks get the existing completion contract.
+ * Ad-hoc sessions get only the MCP note and persona prompt.
+ * Task title and description are NOT included here — they belong in the user prompt
+ * (see {@link buildTaskPrompt}).
+ */
+export class SystemPromptBuilder {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /** Build the complete system prompt string. */
+    build() {
+        const sections = [];
+        // Persona prompt (always first when present)
+        if (this.options.personaPrompt) {
+            sections.push(this.options.personaPrompt);
+        }
+        if (this.options.task) {
+            if (this.isOrchestrator()) {
+                sections.push(this.buildOrchestratorTaskContext());
+                sections.push(this.buildWorkspaceContext());
+                sections.push(this.buildTaskTree());
+                sections.push(this.buildAvailablePersonas());
+                sections.push(this.buildAvailableEnvironments());
+                sections.push(this.buildOrchestratorFindingsSection());
+                sections.push(this.buildTriggerContext());
+                sections.push(this.buildDecompositionGuidelines());
+                sections.push(this.buildOrchestratorTools());
+                sections.push(this.buildOrchestratorCompletionContract());
+                sections.push(this.buildSignalSection());
+            }
+            else {
+                // Leaf task: title/description go in the user prompt (buildTaskPrompt), not here.
+                sections.push(this.buildCompletionContract());
+                sections.push(this.buildSubtaskSection());
+                sections.push(this.buildSignalSection());
+                sections.push(this.buildFindingsSection());
+            }
+        }
+        // IPC fd cleanup instructions (always included — harmless if agent doesn't use IPC)
+        sections.push(this.buildIpcFdSection());
+        // MCP note (always included)
+        sections.push(this.buildMcpNote());
+        return sections.filter(Boolean).join("\n\n");
+    }
+    // ─── Orchestrator Detection ──────────────────────────────
+    /**
+     * Determine whether this is an orchestrator task.
+     * Requires canDecompose, shallow depth, AND orchestrator data fields to be
+     * present. This ensures existing callers that pass canDecompose without
+     * the new fields still get the leaf template.
+     */
+    isOrchestrator() {
+        return this.options.canDecompose === true
+            && this.options.taskDepth !== undefined
+            && this.options.taskDepth <= 1
+            && this.options.taskTree !== undefined;
+    }
+    // ─── Orchestrator Sections ───────────────────────────────
+    /** Orchestrator task context with role framing. */
+    buildOrchestratorTaskContext() {
+        const { title, description, notes } = this.options.task;
+        const parts = [
+            `## Your Task: ${title}`,
+            `You are an **orchestrator agent** responsible for decomposing and coordinating work. You do not write code directly — you break work into subtasks, assign personas, manage dependencies, and monitor progress.`,
+        ];
+        if (description) {
+            parts.push(description);
+        }
+        if (notes) {
+            parts.push(`### Notes (from previous attempt or user feedback)\n${notes}`);
+        }
+        return parts.join("\n\n");
+    }
+    /** Workspace metadata section. */
+    buildWorkspaceContext() {
+        const ws = this.options.workspace;
+        if (!ws) {
+            return "";
+        }
+        const lines = [`## Workspace Context`];
+        lines.push(`- **Name**: ${ws.name}`);
+        if (ws.description) {
+            lines.push(`- **Description**: ${ws.description}`);
+        }
+        if (ws.repoUrl) {
+            lines.push(`- **Repository**: ${ws.repoUrl}`);
+        }
+        return lines.join("\n");
+    }
+    /** Hierarchical task tree with statuses, personas, and dependencies. */
+    buildTaskTree() {
+        const nodes = this.options.taskTree;
+        if (!nodes || nodes.length === 0) {
+            return "";
+        }
+        // Build parent → children map
+        const childMap = new Map();
+        for (const node of nodes) {
+            const key = node.parentTaskId || "";
+            const children = childMap.get(key);
+            if (children) {
+                children.push(node);
+            }
+            else {
+                childMap.set(key, [node]);
+            }
+        }
+        // Status summary
+        const counts = new Map();
+        for (const node of nodes) {
+            counts.set(node.status, (counts.get(node.status) || 0) + 1);
+        }
+        const summary = [...counts.entries()]
+            .map(([status, count]) => `${count} ${status}`)
+            .join(", ");
+        // Recursive render
+        const lines = [];
+        const renderNode = (node, indent) => {
+            const pad = "  ".repeat(indent);
+            const persona = node.personaName ? ` (persona: ${node.personaName})` : "";
+            const deps = node.dependsOn.length > 0
+                ? ` [depends on: ${node.dependsOn.join(", ")}]`
+                : "";
+            const branch = node.branch ? ` [branch: ${node.branch}]` : "";
+            const marker = node.id === this.options.taskId ? " <-- YOU" : "";
+            lines.push(`${pad}- [${node.status}] ${node.title}${persona}${deps}${branch}${marker}`);
+            const children = childMap.get(node.id);
+            if (children) {
+                for (const child of children) {
+                    renderNode(child, indent + 1);
+                }
+            }
+        };
+        // Start from root nodes
+        const roots = childMap.get("") || [];
+        for (const root of roots) {
+            renderNode(root, 0);
+        }
+        return `## Task Tree\n\nStatus: ${summary}\n\n${lines.join("\n")}`;
+    }
+    /** Available personas table. */
+    buildAvailablePersonas() {
+        const personas = this.options.availablePersonas;
+        if (!personas || personas.length === 0) {
+            return "";
+        }
+        const rows = personas.map((p) => `| ${p.name} | ${p.description || "—"} | ${p.runtime || "—"} | ${p.model || "—"} |`);
+        return [
+            `## Available Personas`,
+            ``,
+            `| Name | Description | Runtime | Model |`,
+            `|------|-------------|---------|-------|`,
+            ...rows,
+        ].join("\n");
+    }
+    /** Available environments table. */
+    buildAvailableEnvironments() {
+        const envs = this.options.availableEnvironments;
+        if (!envs || envs.length === 0) {
+            return "";
+        }
+        const rows = envs.map((e) => `| ${e.displayName} | ${e.adapterType} | ${e.status} | ${e.defaultRuntime || "—"} |`);
+        return [
+            `## Available Environments`,
+            ``,
+            `| Name | Adapter | Status | Runtime |`,
+            `|------|---------|--------|---------|`,
+            ...rows,
+        ].join("\n");
+    }
+    /** Orchestrator findings section with actual findings data. */
+    buildOrchestratorFindingsSection() {
+        if (!this.options.findingsContext) {
+            return "";
+        }
+        return this.options.findingsContext;
+    }
+    /** Trigger context describing why this invocation happened. */
+    buildTriggerContext() {
+        if (this.options.triggerMode === "resume") {
+            return [
+                `## Trigger Context`,
+                `You are being re-invoked after one or more child tasks completed. Review the task tree above for current statuses and decide what to do next.`,
+            ].join("\n");
+        }
+        return [
+            `## Trigger Context`,
+            `You are being invoked for the first time to orchestrate this workspace. Assess the current state, then decompose your task into subtasks.`,
+        ].join("\n");
+    }
+    /** Decomposition heuristics and guardrails. */
+    buildDecompositionGuidelines() {
+        return [
+            `## Decomposition Guidelines`,
+            ``,
+            `- Estimate task complexity before decomposing. Do not decompose simple tasks (under ~100 lines of code or touching fewer than 3 files).`,
+            `- Favor context-boundary decomposition over role-boundary decomposition: the agent implementing a feature should also write its tests.`,
+            `- Consider coordination cost vs. parallel benefit. Decomposition multiplies token usage by 3-10x.`,
+            `- Keep the number of direct subtasks reasonable (aim for 3-7 per parent).`,
+            `- Each subtask description must be self-contained — the child agent has no context beyond what you provide in the description.`,
+            `- Set dependencies between subtasks when ordering matters. Independent subtasks can run in parallel.`,
+            `- Grant decomposition rights (\`canDecompose: true\`) only to subtasks that genuinely need to coordinate further work.`,
+        ].join("\n");
+    }
+    /** Orchestrator-specific MCP tool documentation. */
+    buildOrchestratorTools() {
+        return [
+            `## Orchestrator Tools`,
+            ``,
+            `Use these tools on your \`grackle\` MCP server to coordinate work:`,
+            `- \`task_create\` — Create a subtask with title, description, dependencies, persona, and decomposition rights.`,
+            `- \`task_list\` — List all tasks in the workspace with their current statuses.`,
+            `- \`task_show\` — Show details of a specific task including its sessions and output.`,
+            `- \`task_start\` — Start a task (begins agent execution on the assigned environment).`,
+            `- \`task_complete\` — Signal that your task is complete.`,
+            `- \`finding_post\` — Share a discovery (architecture decisions, patterns, bugs) with other agents.`,
+            `- \`finding_list\` — List recent findings from all agents in this workspace.`,
+        ].join("\n");
+    }
+    /** Orchestrator-specific completion contract. */
+    buildOrchestratorCompletionContract() {
+        return [
+            `## Completion`,
+            `When all subtasks are complete and you have verified the results, use \`task_complete\` to signal your own completion. If any subtasks failed, decide whether to retry, reassign, or handle the failure before completing.`,
+        ].join("\n");
+    }
+    // ─── Leaf Sections (unchanged) ───────────────────────────
+    /** Task title, description, and notes. */
+    buildTaskContext() {
+        const { title, description, notes } = this.options.task;
+        const parts = [
+            `## Task: ${title}`,
+            description,
+        ];
+        if (notes) {
+            parts.push(`## Notes (from previous attempt or user feedback)\n${notes}`);
+        }
+        return parts.filter(Boolean).join("\n\n");
+    }
+    /** Contract for signaling task completion. */
+    buildCompletionContract() {
+        return [
+            `## Completion`,
+            `When you are done with your task, use \`task_complete\` to signal completion. Do not go idle without signaling — the orchestrator depends on an explicit completion signal to know you are finished.`,
+        ].join("\n");
+    }
+    /** Subtask guidance based on canDecompose. */
+    buildSubtaskSection() {
+        if (this.options.canDecompose) {
+            return [
+                `## Subtasks`,
+                `If this task is too large or complex to complete alone, use \`task_create\` to decompose it into subtasks. Monitor their progress with \`task_list\` and \`task_show\`. Wait for subtasks to finish before marking your own task complete.`,
+            ].join("\n");
+        }
+        return [
+            `## Subtasks`,
+            `Subtask creation is disabled for this task. Complete the work yourself.`,
+        ].join("\n");
+    }
+    /** SIGCHLD signal documentation. */
+    buildSignalSection() {
+        return [
+            `## Signals`,
+            `You may receive \`[SIGCHLD]\` messages when a child task finishes, fails, or is interrupted. When you receive one:`,
+            `1. Review the child's status and last output (included in the signal).`,
+            `2. If the child succeeded, check whether all subtasks are done and mark your task complete if so.`,
+            `3. If the child failed or was interrupted, decide whether to retry, reassign, or handle the failure yourself.`,
+        ].join("\n");
+    }
+    /** Guidance on using findings (leaf agents). */
+    buildFindingsSection() {
+        return [
+            `## Findings`,
+            `Use \`finding_post\` to share discoveries (architecture decisions, bugs, patterns) with other agents. Check \`finding_list\` before posting to avoid duplicates.`,
+        ].join("\n");
+    }
+    /** IPC fd cleanup instructions — advisory enforcement for closing child fds before exit. */
+    buildIpcFdSection() {
+        return [
+            "## IPC File Descriptors",
+            "",
+            "If you spawn child sessions using `ipc_spawn`, you receive file descriptors (fds).",
+            "Before finishing your work, you MUST:",
+            "1. Call `ipc_list_fds` to check for open fds",
+            "2. For each owned fd (`owned: true`), call `ipc_close` to close it",
+            "3. Only then should you stop working",
+            "",
+            "Failing to close your fds will leave child sessions running indefinitely.",
+        ].join("\n");
+    }
+    /** MCP note (always included). */
+    buildMcpNote() {
+        return `You have tools on your \`grackle\` MCP server.`;
+    }
+}
+//# sourceMappingURL=system-prompt-builder.js.map

package/dist/system-prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt-builder.js","sourceRoot":"","sources":["../src/system-prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qFAAqF;AACrF,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,WAAmB,EAAE,KAAc;IAChF,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;IACtB,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAiFD,gEAAgE;AAEhE;;;;;;;;GAQG;AACH,MAAM,OAAO,mBAAmB;IACb,OAAO,CAAsB;IAE9C,YAAmB,OAA4B;QAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,+CAA+C;IACxC,KAAK;QACV,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,6CAA6C;QAC7C,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;gBAC1B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,4BAA4B,EAAE,CAAC,CAAC;gBACnD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAC;gBAC5C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;gBACpC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;gBAC7C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,0BAA0B,EAAE,CAAC,CAAC;gBACjD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,gCAAgC,EAAE,CAAC,CAAC;gBACvD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;gBAC1C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,4BAA4B,EAAE,CAAC,CAAC;gBACnD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;gBAC7C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,mCAAmC,EAAE,CAAC,CAAC;gBAC1D,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,kFAAkF;gBAClF,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC,CAAC;gBAC9C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;gBAC1C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;gBACzC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,oFAAoF;QACpF,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAExC,6BAA6B;QAC7B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAEnC,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,4DAA4D;IAE5D;;;;;OAKG;IACK,cAAc;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,KAAK,IAAI;eACpC,IAAI,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;eACpC,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC;eAC3B,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC;IAC3C,CAAC;IAED,4DAA4D;IAE5D,mDAAmD;IAC3C,4BAA4B;QAClC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAK,CAAC;QACzD,MAAM,KAAK,GAAG;YACZ,iBAAiB,KAAK,EAAE;YACxB,iNAAiN;SAClN,CAAC;QACF,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,IAAI,CAAC,uDAAuD,KAAK,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,kCAAkC;IAC1B,qBAAqB;QAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACrC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,wEAAwE;IAChE,aAAa;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;QACnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,iBAAiB;QACjB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;aAClC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,MAAM,EAAE,CAAC;aAC9C,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,mBAAmB;QACnB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,CAAC,IAAkB,EAAE,MAAc,EAAQ,EAAE;YAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;gBACpC,CAAC,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAC/C,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;YAExF,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;oBAC7B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,wBAAwB;QACxB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACtB,CAAC;QAED,OAAO,2BAA2B,OAAO,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACrE,CAAC;IAED,gCAAgC;IACxB,sBAAsB;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC;QAChD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CACvB,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,WAAW,IAAI,GAAG,MAAM,CAAC,CAAC,OAAO,IAAI,GAAG,MAAM,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAC3F,CAAC;QACF,OAAO;YACL,uBAAuB;YACvB,EAAE;YACF,0CAA0C;YAC1C,0CAA0C;YAC1C,GAAG,IAAI;SACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,oCAAoC;IAC5B,0BAA0B;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC;QAChD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CACnB,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,WAAW,MAAM,CAAC,CAAC,WAAW,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,cAAc,IAAI,GAAG,IAAI,CAC5F,CAAC;QACF,OAAO;YACL,2BAA2B;YAC3B,EAAE;YACF,uCAAuC;YACvC,uCAAuC;YACvC,GAAG,IAAI;SACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,+DAA+D;IACvD,gCAAgC;QACtC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAClC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;IACtC,CAAC;IAED,+DAA+D;IACvD,mBAAmB;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YAC1C,OAAO;gBACL,oBAAoB;gBACpB,+IAA+I;aAChJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;QACD,OAAO;YACL,oBAAoB;YACpB,2IAA2I;SAC5I,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,+CAA+C;IACvC,4BAA4B;QAClC,OAAO;YACL,6BAA6B;YAC7B,EAAE;YACF,yIAAyI;YACzI,wIAAwI;YACxI,mGAAmG;YACnG,2EAA2E;YAC3E,gIAAgI;YAChI,sGAAsG;YACtG,wHAAwH;SACzH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,oDAAoD;IAC5C,sBAAsB;QAC5B,OAAO;YACL,uBAAuB;YACvB,EAAE;YACF,oEAAoE;YACpE,gHAAgH;YAChH,gFAAgF;YAChF,sFAAsF;YACtF,uFAAuF;YACvF,0DAA0D;YAC1D,oGAAoG;YACpG,8EAA8E;SAC/E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,iDAAiD;IACzC,mCAAmC;QACzC,OAAO;YACL,eAAe;YACf,4NAA4N;SAC7N,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,4DAA4D;IAE5D,0CAA0C;IAClC,gBAAgB;QACtB,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAK,CAAC;QACzD,MAAM,KAAK,GAAG;YACZ,YAAY,KAAK,EAAE;YACnB,WAAW;SACZ,CAAC;QACF,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,IAAI,CAAC,sDAAsD,KAAK,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,8CAA8C;IACtC,uBAAuB;QAC7B,OAAO;YACL,eAAe;YACf,sMAAsM;SACvM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,8CAA8C;IACtC,mBAAmB;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAC9B,OAAO;gBACL,aAAa;gBACb,4OAA4O;aAC7O,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;QACD,OAAO;YACL,aAAa;YACb,yEAAyE;SAC1E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,oCAAoC;IAC5B,kBAAkB;QACxB,OAAO;YACL,YAAY;YACZ,oHAAoH;YACpH,wEAAwE;YACxE,mGAAmG;YACnG,+GAA+G;SAChH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,gDAAgD;IACxC,oBAAoB;QAC1B,OAAO;YACL,aAAa;YACb,kKAAkK;SACnK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,4FAA4F;IACpF,iBAAiB;QACvB,OAAO;YACL,yBAAyB;YACzB,EAAE;YACF,oFAAoF;YACpF,uCAAuC;YACvC,8CAA8C;YAC9C,oEAAoE;YACpE,sCAAsC;YACtC,EAAE;YACF,2EAA2E;SAC5E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,kCAAkC;IAC1B,YAAY;QAClB,OAAO,gDAAgD,CAAC;IAC1D,CAAC;CACF"}

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.57.7"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@grackle-ai/prompt",
+  "version": "0.73.1",
+  "description": "System prompt assembly and persona resolution for Grackle agent sessions",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nick-pape/grackle.git",
+    "directory": "packages/prompt"
+  },
+  "keywords": [
+    "grackle",
+    "prompt",
+    "system-prompt",
+    "persona",
+    "orchestrator"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "dependencies": {
+    "@grackle-ai/database": "0.73.1"
+  },
+  "devDependencies": {
+    "@rushstack/heft": "1.2.7",
+    "@types/node": "^22.0.0",
+    "vitest": "^3.1.1",
+    "@grackle-ai/heft-rig": "0.0.1"
+  },
+  "scripts": {
+    "build": "heft build --clean",
+    "test": "vitest run",
+    "clean": "heft clean",
+    "_phase:build": "heft run --only build -- --clean",
+    "_phase:test": "vitest run"
+  }
+}