@grackle-ai/prompt 0.83.1 → 0.84.0

package/README.md

@@ -14,22 +14,44 @@ System prompt assembly and persona resolution for [Grackle](https://github.com/n
 
 ## Overview
 
-This package prepares everything an agent session needs before it starts:
+This package is a **pure, zero-dependency** library for building agent session prompts. It has no database or store imports — callers provide pre-fetched data.
 
 - **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.
+- **Orchestrator context** — `buildOrchestratorContext()` transforms pre-fetched data (tasks, personas, environments, findings) into the slim types needed by `SystemPromptBuilder`.
+- **Persona resolution** — `resolvePersona()` resolves which persona to use via a cascade: request persona, task default, workspace default, app default. Accepts a lookup function instead of accessing the database directly.
 
 ## Usage
 
 ```typescript
-import { SystemPromptBuilder, fetchOrchestratorContext, resolvePersona } from "@grackle-ai/prompt";
+import {
+  SystemPromptBuilder,
+  buildOrchestratorContext,
+  resolvePersona,
+} from "@grackle-ai/prompt";
 
-// Resolve the persona for a session
-const resolved = resolvePersona(requestPersonaId, taskDefaultPersonaId, workspaceDefaultPersonaId);
+// Resolve the persona for a session (caller maps DB row to PersonaResolveInput)
+const resolved = resolvePersona(
+  requestPersonaId,
+  taskDefaultPersonaId,
+  workspaceDefaultPersonaId,
+  appDefaultPersonaId,
+  (id) => {
+    const row = personaStore.getPersona(id);
+    if (!row) return undefined;
+    return { id: row.id, name: row.name, runtime: row.runtime, model: row.model,
+      maxTurns: row.maxTurns, systemPrompt: row.systemPrompt, toolConfig: row.toolConfig,
+      mcpServers: row.mcpServers, type: row.type, script: row.script };
+  },
+);
 
-// Fetch orchestrator context (for orchestrator tasks)
-const context = fetchOrchestratorContext(workspaceId);
+// Build orchestrator context from pre-fetched data
+const context = buildOrchestratorContext({
+  workspace: { name: "My Project", description: "...", repoUrl: "..." },
+  tasks: [...],      // TaskInput[]
+  personas: [...],   // PersonaInput[]
+  environments: [...], // EnvironmentInput[]
+  findings: [...],   // FindingInput[]
+});
 
 // Build the system prompt
 const builder = new SystemPromptBuilder({

package/dist/index.d.ts

@@ -1,7 +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 { buildOrchestratorContext } from "./orchestrator-context.js";
+export type { OrchestratorContext, OrchestratorContextInput, TaskInput, PersonaInput, EnvironmentInput, FindingInput } from "./orchestrator-context.js";
 export { resolvePersona } from "./resolve-persona.js";
-export type { ResolvedPersona } from "./resolve-persona.js";
+export type { ResolvedPersona, PersonaResolveInput } from "./resolve-persona.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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,wBAAwB,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGxJ,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

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

package/dist/orchestrator-context.d.ts

@@ -1,10 +1,80 @@
 /**
- * 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.
+ * Builds the orchestrator context from pre-fetched data.
+ * Pure function — no database or store dependencies.
  */
 import type { TaskTreeNode, PersonaSummary, EnvironmentSummary } from "./system-prompt-builder.js";
-/** Pre-fetched orchestrator data matching SystemPromptOptions fields. */
+/** Pre-parsed task data for building orchestrator context. */
+export interface TaskInput {
+    /** Task ID. */
+    id: string;
+    /** Task title. */
+    title: string;
+    /** Current lifecycle status. */
+    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 (pre-parsed from JSON). */
+    dependsOn: string[];
+    /** Default persona ID for this task. */
+    defaultPersonaId: string;
+    /** Git branch name (empty if none). */
+    branch: string;
+    /** Whether this task can create subtasks. */
+    canDecompose: boolean;
+}
+/** Persona data for building orchestrator context. */
+export interface PersonaInput {
+    /** Persona ID. */
+    id: string;
+    /** Display name. */
+    name: string;
+    /** Short description. */
+    description: string;
+    /** Runtime backend. */
+    runtime: string;
+    /** Default model. */
+    model: string;
+}
+/** Environment data for building orchestrator context. */
+export interface EnvironmentInput {
+    /** Human-readable name. */
+    displayName: string;
+    /** Adapter backend (local, ssh, codespace, docker). */
+    adapterType: string;
+    /** Connection status. */
+    status: string;
+    /** Default runtime for this environment. */
+    defaultRuntime: string;
+}
+/** Finding data for building orchestrator context. */
+export interface FindingInput {
+    /** Finding category (decision, bug, pattern, etc.). */
+    category: string;
+    /** Finding title. */
+    title: string;
+    /** Finding content. */
+    content: string;
+}
+/** All input data needed to build orchestrator context. */
+export interface OrchestratorContextInput {
+    /** Workspace metadata (undefined when workspace not found). */
+    workspace?: {
+        name: string;
+        description: string;
+        repoUrl: string;
+    };
+    /** All tasks in the workspace. */
+    tasks: TaskInput[];
+    /** All available personas. */
+    personas: PersonaInput[];
+    /** All available environments. */
+    environments: EnvironmentInput[];
+    /** Recent findings for the workspace. */
+    findings: FindingInput[];
+}
+/** Pre-built orchestrator data matching SystemPromptOptions fields. */
 export interface OrchestratorContext {
     /** Workspace metadata (undefined when workspace not found). */
     workspace?: {
@@ -22,10 +92,10 @@ export interface OrchestratorContext {
     findingsContext: string;
 }
 /**
- * Fetch all data needed for an orchestrator system prompt.
+ * Build orchestrator context from pre-fetched data.
  *
- * @param workspaceId - The workspace to scope task/findings queries to.
+ * @param input - Pre-fetched workspace, task, persona, environment, and finding data.
  * @returns Data ready to spread into SystemPromptOptions.
  */
-export declare function fetchOrchestratorContext(workspaceId: string): OrchestratorContext | undefined;
+export declare function buildOrchestratorContext(input: OrchestratorContextInput): OrchestratorContext;
 //# sourceMappingURL=orchestrator-context.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"orchestrator-context.d.ts","sourceRoot":"","sources":["../src/orchestrator-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAInG,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACxB,eAAe;IACf,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,wCAAwC;IACxC,gBAAgB,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,2DAA2D;AAC3D,MAAM,WAAW,wBAAwB;IACvC,+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,kCAAkC;IAClC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,8BAA8B;IAC9B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,kCAAkC;IAClC,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,yCAAyC;IACzC,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,uEAAuE;AACvE,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,KAAK,EAAE,wBAAwB,GAAG,mBAAmB,CA8C7F"}

package/dist/orchestrator-context.js

@@ -1,60 +1,45 @@
-import { taskStore, personaStore, envRegistry, findingStore, workspaceStore, safeParseJsonArray } from "@grackle-ai/database";
 /**
- * Fetch all data needed for an orchestrator system prompt.
+ * Build orchestrator context from pre-fetched data.
  *
- * @param workspaceId - The workspace to scope task/findings queries to.
+ * @param input - Pre-fetched workspace, task, persona, environment, and finding data.
  * @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();
+export function buildOrchestratorContext(input) {
+    // Build persona ID → name map for task tree persona name resolution
     const personaNameMap = new Map();
-    for (const p of allPersonas) {
+    for (const p of input.personas) {
         personaNameMap.set(p.id, p.name);
     }
-    // All tasks in this workspace → TaskTreeNode[]
-    const allTasks = taskStore.listTasks(workspaceId || undefined);
-    const taskTree = allTasks.map((t) => ({
+    // Map tasks → TaskTreeNode[]
+    const taskTree = input.tasks.map((t) => ({
         id: t.id,
         title: t.title,
         status: t.status,
         depth: t.depth,
         parentTaskId: t.parentTaskId,
-        dependsOn: safeParseJsonArray(t.dependsOn),
+        dependsOn: t.dependsOn,
         personaName: personaNameMap.get(t.defaultPersonaId) || "",
         branch: t.branch,
         canDecompose: t.canDecompose,
     }));
-    // Available personas
-    const availablePersonas = allPersonas.map((p) => ({
+    // Map personas → PersonaSummary[]
+    const availablePersonas = input.personas.map((p) => ({
         name: p.name,
         description: p.description,
         runtime: p.runtime,
         model: p.model,
     }));
-    // Available environments
-    const availableEnvironments = envRegistry.listEnvironments().map((e) => ({
+    // Map environments → EnvironmentSummary[]
+    const availableEnvironments = input.environments.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)
-        : "";
+    // Build findings context (pre-formatted markdown with 8K char budget)
+    const findingsContext = buildFindingsContext(input.findings);
     return {
-        workspace: ws ? {
-            name: ws.name,
-            description: ws.description,
-            repoUrl: ws.repoUrl,
-        } : undefined,
+        workspace: input.workspace,
         taskTree,
         availablePersonas,
         availableEnvironments,
@@ -66,15 +51,14 @@ export function fetchOrchestratorContext(workspaceId) {
 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) {
+/** Build a summarized text context of recent findings. */
+function buildFindingsContext(findings) {
+    if (findings.length === 0) {
         return "";
     }
     const lines = ["## Workspace Findings (shared knowledge from other agents)\n"];
     let totalChars = lines[0].length;
-    for (const f of allFindings) {
+    for (const f of findings) {
         const content = f.content.length > FINDINGS_MAX_PER_FINDING
             ? f.content.slice(0, FINDINGS_MAX_PER_FINDING) + "..."
             : f.content;

package/dist/orchestrator-context.js.map

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

package/dist/resolve-persona.d.ts

@@ -1,4 +1,30 @@
-import type { PersonaRow } from "@grackle-ai/database";
+/**
+ * Persona resolution with cascade logic.
+ * Pure function — no database or store dependencies.
+ */
+/** Database-agnostic persona data for resolution. */
+export interface PersonaResolveInput {
+    /** Persona ID. */
+    id: string;
+    /** Display name. */
+    name: 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;
+}
 /** Resolved persona fields needed to start a session. */
 export interface ResolvedPersona {
     /** The persona ID that was resolved. */
@@ -19,15 +45,20 @@ export interface ResolvedPersona {
     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
+ *   request persona, task default, workspace default, app default, then error
+ *
+ * The first non-empty persona ID in the cascade is used to look up the persona
+ * via the provided lookup function. Throws if no persona ID is found at any
+ * level, or if the resolved ID does not exist.
  *
- * 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.
+ * @param requestPersonaId - Persona ID from the request (highest priority).
+ * @param taskDefaultPersonaId - Task-level default persona ID.
+ * @param workspaceDefaultPersonaId - Workspace-level default persona ID.
+ * @param appDefaultPersonaId - App-level default persona ID (pre-fetched from settings).
+ * @param lookupPersona - Function to look up a persona by ID. Returns undefined if not found.
  */
-export declare function resolvePersona(requestPersonaId: string, taskDefaultPersonaId?: string, workspaceDefaultPersonaId?: string): ResolvedPersona;
+export declare function resolvePersona(requestPersonaId: string, taskDefaultPersonaId: string | undefined, workspaceDefaultPersonaId: string | undefined, appDefaultPersonaId: string | undefined, lookupPersona: (id: string) => PersonaResolveInput | undefined): ResolvedPersona;
 //# sourceMappingURL=resolve-persona.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"resolve-persona.d.ts","sourceRoot":"","sources":["../src/resolve-persona.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,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;CAChB;AAED,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;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,MAAM,EACxB,oBAAoB,EAAE,MAAM,GAAG,SAAS,EACxC,yBAAyB,EAAE,MAAM,GAAG,SAAS,EAC7C,mBAAmB,EAAE,MAAM,GAAG,SAAS,EACvC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,mBAAmB,GAAG,SAAS,GAC7D,eAAe,CAwCjB"}

package/dist/resolve-persona.js

@@ -1,21 +1,31 @@
-import { personaStore, settingsStore } from "@grackle-ai/database";
+/**
+ * Persona resolution with cascade logic.
+ * Pure function — no database or store dependencies.
+ */
 /**
  * Resolve a persona using the cascade:
- *   request persona → task default → workspace default → app default → error
+ *   request persona, task default, workspace default, app default, then error
+ *
+ * The first non-empty persona ID in the cascade is used to look up the persona
+ * via the provided lookup function. Throws if no persona ID is found at any
+ * level, or if the resolved ID does not exist.
  *
- * 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.
+ * @param requestPersonaId - Persona ID from the request (highest priority).
+ * @param taskDefaultPersonaId - Task-level default persona ID.
+ * @param workspaceDefaultPersonaId - Workspace-level default persona ID.
+ * @param appDefaultPersonaId - App-level default persona ID (pre-fetched from settings).
+ * @param lookupPersona - Function to look up a persona by ID. Returns undefined if not found.
  */
-export function resolvePersona(requestPersonaId, taskDefaultPersonaId, workspaceDefaultPersonaId) {
+export function resolvePersona(requestPersonaId, taskDefaultPersonaId, workspaceDefaultPersonaId, appDefaultPersonaId, lookupPersona) {
     const personaId = requestPersonaId ||
         taskDefaultPersonaId ||
         workspaceDefaultPersonaId ||
-        settingsStore.getSetting("default_persona_id") ||
+        appDefaultPersonaId ||
         "";
     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);
+    const persona = lookupPersona(personaId);
     if (!persona) {
         throw new Error(`Persona not found: ${personaId}`);
     }
@@ -37,7 +47,6 @@ export function resolvePersona(requestPersonaId, taskDefaultPersonaId, workspace
         mcpServers: persona.mcpServers,
         type: personaType,
         script: persona.script,
-        persona,
     };
 }
 //# sourceMappingURL=resolve-persona.js.map

package/dist/resolve-persona.js.map

@@ -1 +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"}
+{"version":3,"file":"resolve-persona.js","sourceRoot":"","sources":["../src/resolve-persona.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgDH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAC5B,gBAAwB,EACxB,oBAAwC,EACxC,yBAA6C,EAC7C,mBAAuC,EACvC,aAA8D;IAE9D,MAAM,SAAS,GACb,gBAAgB;QAChB,oBAAoB;QACpB,yBAAyB;QACzB,mBAAmB;QACnB,EAAE,CAAC;IAEL,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,+GAA+G,CAChH,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACzC,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;KACvB,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grackle-ai/prompt",
-  "version": "0.83.1",
+  "version": "0.84.0",
   "description": "System prompt assembly and persona resolution for Grackle agent sessions",
   "license": "MIT",
   "repository": {
@@ -28,9 +28,7 @@
   "files": [
     "dist/"
   ],
-  "dependencies": {
-    "@grackle-ai/database": "0.83.1"
-  },
+  "dependencies": {},
   "devDependencies": {
     "@rushstack/heft": "1.2.7",
     "@types/node": "^22.0.0",