agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/agentic-flow/src/orchestration/memory-plane-types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Memory plane API - Types (PR3)
+ */
+/** Entry for seedMemory. */
+export interface MemoryEntry {
+    /** Optional key. */
+    key?: string;
+    /** Content value. */
+    value: string;
+    /** Optional metadata. */
+    metadata?: Record<string, unknown>;
+}
+/** Result item from searchMemory. */
+export interface MemorySearchResult {
+    value: string;
+    score?: number;
+    metadata?: Record<string, unknown>;
+}
+/** Scope for search: run-scoped or global. */
+export type MemorySearchScope = {
+    runId: string;
+} | 'global';
+//# sourceMappingURL=memory-plane-types.d.ts.map

package/dist/agentic-flow/src/orchestration/memory-plane-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-plane-types.d.ts","sourceRoot":"","sources":["../../../../src/orchestration/memory-plane-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,oBAAoB;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,qCAAqC;AACrC,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,8CAA8C;AAC9C,MAAM,MAAM,iBAAiB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAAC"}

package/dist/agentic-flow/src/orchestration/memory-plane-types.js

@@ -0,0 +1,5 @@
+/**
+ * Memory plane API - Types (PR3)
+ */
+export {};
+//# sourceMappingURL=memory-plane-types.js.map

package/dist/agentic-flow/src/orchestration/memory-plane-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-plane-types.js","sourceRoot":"","sources":["../../../../src/orchestration/memory-plane-types.ts"],"names":[],"mappings":"AAAA;;GAEG","sourcesContent":["/**\n * Memory plane API - Types (PR3)\n */\n\n/** Entry for seedMemory. */\nexport interface MemoryEntry {\n  /** Optional key. */\n  key?: string;\n  /** Content value. */\n  value: string;\n  /** Optional metadata. */\n  metadata?: Record<string, unknown>;\n}\n\n/** Result item from searchMemory. */\nexport interface MemorySearchResult {\n  value: string;\n  score?: number;\n  metadata?: Record<string, unknown>;\n}\n\n/** Scope for search: run-scoped or global. */\nexport type MemorySearchScope = { runId: string } | 'global';\n"]}

package/dist/agentic-flow/src/orchestration/memory-plane.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Memory plane implementation (PR3)
+ *
+ * Explicit methods so vector memorization and run context are guaranteed.
+ * In-memory implementation; can be wired to AgentDB/ReasoningBank/safe-exec later.
+ */
+import type { MemoryEntry, MemorySearchResult, MemorySearchScope } from './memory-plane-types.js';
+/**
+ * Seed run context so the run sees these entries. Guaranteed, not prompt-only.
+ */
+export declare function seedMemory(runId: string, entries: Array<{
+    key?: string;
+    value: string;
+    metadata?: Record<string, unknown>;
+}>): Promise<void>;
+/**
+ * Record a learning/pattern for the run (e.g. for ReasoningBank/pattern store).
+ */
+export declare function recordLearning(runId: string, learning: string, score?: number, provenance?: Record<string, unknown>): Promise<void>;
+/**
+ * Search memory. Scope is run-scoped (when runId present) or 'global'.
+ * Returns up to topK results. In-memory impl uses simple substring match.
+ */
+export declare function searchMemory(scope: MemorySearchScope | {
+    runId?: string;
+}, query: string, topK: number): Promise<MemorySearchResult[]>;
+/** Learning record stored for a run. */
+export interface RunLearning {
+    learning: string;
+    score?: number;
+    provenance?: Record<string, unknown>;
+}
+/**
+ * Harvest run-scoped memory (entries + learnings) for a run. Use after completion
+ * to pull context and learnings with provenance for audit or reuse.
+ */
+export declare function harvestMemory(runId: string): Promise<{
+    entries: MemoryEntry[];
+    learnings: RunLearning[];
+}>;
+//# sourceMappingURL=memory-plane.d.ts.map

package/dist/agentic-flow/src/orchestration/memory-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-plane.d.ts","sourceRoot":"","sources":["../../../../src/orchestration/memory-plane.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAQlG;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,KAAK,CAAC;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GAClF,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyC/B;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1D,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B,CAAC,CAID"}

package/dist/agentic-flow/src/orchestration/memory-plane.js

@@ -0,0 +1,84 @@
+/**
+ * Memory plane implementation (PR3)
+ *
+ * Explicit methods so vector memorization and run context are guaranteed.
+ * In-memory implementation; can be wired to AgentDB/ReasoningBank/safe-exec later.
+ */
+/** Run-scoped seeded entries: runId -> entries. */
+const runEntriesStore = new Map();
+/** Run-scoped learnings: runId -> { learning, score?, provenance? }[]. */
+const runLearningsStore = new Map();
+/**
+ * Seed run context so the run sees these entries. Guaranteed, not prompt-only.
+ */
+export async function seedMemory(runId, entries) {
+    const existing = runEntriesStore.get(runId) ?? [];
+    runEntriesStore.set(runId, [...existing, ...entries]);
+}
+/**
+ * Record a learning/pattern for the run (e.g. for ReasoningBank/pattern store).
+ */
+export async function recordLearning(runId, learning, score, provenance) {
+    const existing = runLearningsStore.get(runId) ?? [];
+    existing.push({ learning, score, provenance });
+    runLearningsStore.set(runId, existing);
+}
+/**
+ * Search memory. Scope is run-scoped (when runId present) or 'global'.
+ * Returns up to topK results. In-memory impl uses simple substring match.
+ */
+export async function searchMemory(scope, query, topK) {
+    const q = query.toLowerCase();
+    const results = [];
+    const runId = typeof scope === 'object' && scope && 'runId' in scope ? scope.runId : undefined;
+    const scoreMatch = (text) => {
+        const t = text.toLowerCase();
+        if (t.includes(q))
+            return 0.9;
+        const words = q.split(/\s+/).filter(Boolean);
+        const hits = words.filter((w) => t.includes(w)).length;
+        return words.length ? hits / words.length : 0;
+    };
+    if (runId) {
+        const entries = runEntriesStore.get(runId) ?? [];
+        const learnings = runLearningsStore.get(runId) ?? [];
+        for (const e of entries) {
+            const score = scoreMatch(e.value);
+            if (score > 0)
+                results.push({ value: e.value, score, metadata: e.metadata });
+        }
+        for (const { learning, score: s } of learnings) {
+            const score = scoreMatch(learning);
+            if (score > 0)
+                results.push({ value: learning, score: s ?? score });
+        }
+    }
+    else {
+        for (const [, entries] of runEntriesStore) {
+            for (const e of entries) {
+                const score = scoreMatch(e.value);
+                if (score > 0)
+                    results.push({ value: e.value, score, metadata: e.metadata });
+            }
+        }
+        for (const [, learnings] of runLearningsStore) {
+            for (const { learning, score: s } of learnings) {
+                const score = scoreMatch(learning);
+                if (score > 0)
+                    results.push({ value: learning, score: s ?? score });
+            }
+        }
+    }
+    results.sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
+    return results.slice(0, Math.max(0, topK));
+}
+/**
+ * Harvest run-scoped memory (entries + learnings) for a run. Use after completion
+ * to pull context and learnings with provenance for audit or reuse.
+ */
+export async function harvestMemory(runId) {
+    const entries = runEntriesStore.get(runId) ?? [];
+    const learnings = runLearningsStore.get(runId) ?? [];
+    return { entries: [...entries], learnings: [...learnings] };
+}
+//# sourceMappingURL=memory-plane.js.map

package/dist/agentic-flow/src/orchestration/memory-plane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-plane.js","sourceRoot":"","sources":["../../../../src/orchestration/memory-plane.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Memory plane implementation (PR3)\n *\n * Explicit methods so vector memorization and run context are guaranteed.\n * In-memory implementation; can be wired to AgentDB/ReasoningBank/safe-exec later.\n */\n\nimport type { MemoryEntry, MemorySearchResult, MemorySearchScope } from './memory-plane-types.js';\n\n/** Run-scoped seeded entries: runId -> entries. */\nconst runEntriesStore = new Map<string, MemoryEntry[]>();\n\n/** Run-scoped learnings: runId -> { learning, score?, provenance? }[]. */\nconst runLearningsStore = new Map<string, Array<{ learning: string; score?: number; provenance?: Record<string, unknown> }>>();\n\n/**\n * Seed run context so the run sees these entries. Guaranteed, not prompt-only.\n */\nexport async function seedMemory(\n  runId: string,\n  entries: Array<{ key?: string; value: string; metadata?: Record<string, unknown> }>\n): Promise<void> {\n  const existing = runEntriesStore.get(runId) ?? [];\n  runEntriesStore.set(runId, [...existing, ...entries]);\n}\n\n/**\n * Record a learning/pattern for the run (e.g. for ReasoningBank/pattern store).\n */\nexport async function recordLearning(\n  runId: string,\n  learning: string,\n  score?: number,\n  provenance?: Record<string, unknown>\n): Promise<void> {\n  const existing = runLearningsStore.get(runId) ?? [];\n  existing.push({ learning, score, provenance });\n  runLearningsStore.set(runId, existing);\n}\n\n/**\n * Search memory. Scope is run-scoped (when runId present) or 'global'.\n * Returns up to topK results. In-memory impl uses simple substring match.\n */\nexport async function searchMemory(\n  scope: MemorySearchScope | { runId?: string },\n  query: string,\n  topK: number\n): Promise<MemorySearchResult[]> {\n  const q = query.toLowerCase();\n  const results: MemorySearchResult[] = [];\n  const runId = typeof scope === 'object' && scope && 'runId' in scope ? scope.runId : undefined;\n\n  const scoreMatch = (text: string): number => {\n    const t = text.toLowerCase();\n    if (t.includes(q)) return 0.9;\n    const words = q.split(/\\s+/).filter(Boolean);\n    const hits = words.filter((w) => t.includes(w)).length;\n    return words.length ? hits / words.length : 0;\n  };\n\n  if (runId) {\n    const entries = runEntriesStore.get(runId) ?? [];\n    const learnings = runLearningsStore.get(runId) ?? [];\n    for (const e of entries) {\n      const score = scoreMatch(e.value);\n      if (score > 0) results.push({ value: e.value, score, metadata: e.metadata });\n    }\n    for (const { learning, score: s } of learnings) {\n      const score = scoreMatch(learning);\n      if (score > 0) results.push({ value: learning, score: s ?? score });\n    }\n  } else {\n    for (const [, entries] of runEntriesStore) {\n      for (const e of entries) {\n        const score = scoreMatch(e.value);\n        if (score > 0) results.push({ value: e.value, score, metadata: e.metadata });\n      }\n    }\n    for (const [, learnings] of runLearningsStore) {\n      for (const { learning, score: s } of learnings) {\n        const score = scoreMatch(learning);\n        if (score > 0) results.push({ value: learning, score: s ?? score });\n      }\n    }\n  }\n\n  results.sort((a, b) => (b.score ?? 0) - (a.score ?? 0));\n  return results.slice(0, Math.max(0, topK));\n}\n\n/** Learning record stored for a run. */\nexport interface RunLearning {\n  learning: string;\n  score?: number;\n  provenance?: Record<string, unknown>;\n}\n\n/**\n * Harvest run-scoped memory (entries + learnings) for a run. Use after completion\n * to pull context and learnings with provenance for audit or reuse.\n */\nexport async function harvestMemory(runId: string): Promise<{\n  entries: MemoryEntry[];\n  learnings: RunLearning[];\n}> {\n  const entries = runEntriesStore.get(runId) ?? [];\n  const learnings = runLearningsStore.get(runId) ?? [];\n  return { entries: [...entries], learnings: [...learnings] };\n}\n"]}

package/dist/agentic-flow/src/orchestration/orchestration-client.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Generic orchestration client (Option A).
+ *
+ * Stable input/output shape for apps (build systems, IDEs, CI) that drive
+ * agentic-flow in-process. Map your app payload to StartRunInput; get back
+ * runId and a consistent status/cancel result shape.
+ */
+import type { OrchestratorConfig, LoopPolicy } from './orchestration-types.js';
+import type { MemorySearchScope } from './memory-plane-types.js';
+import type { MemorySearchResult } from './memory-plane-types.js';
+import type { RunLearning } from './memory-plane.js';
+/** Generic input for starting a run. Apps map their payload to this shape. */
+export interface StartRunInput {
+    /** Full task description for the build agent. */
+    taskDescription: string;
+    /** Working directory for the run. */
+    cwd?: string;
+    /** Memory entries to seed before the run (e.g. context refs). */
+    memorySeed?: Array<{
+        key: string;
+        value: string;
+        namespace?: string;
+        metadata?: Record<string, unknown>;
+    }>;
+    /** Acceptance criteria (e.g. "tests pass", "lint clean"). */
+    acceptanceCriteria?: string[];
+    /** Paths the run is allowed to modify. */
+    allowedPaths?: string[];
+    /** Paths the run must not modify. */
+    forbiddenPaths?: string[];
+    /** Provenance (run/card/assignment ids) for audit. */
+    provenance?: {
+        runId?: string;
+        assignmentId?: string;
+        cardId?: string;
+        [key: string]: unknown;
+    };
+    /** Loop policy: max iterations, success criteria, retry, budget. Pass-through for backends. */
+    loopPolicy?: LoopPolicy;
+}
+/** Status state returned by the generic client. */
+export type RunStatusState = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled' | 'unknown';
+/** Generic run status. Apps map this to their own status type if needed. */
+export interface ClientRunStatus {
+    runId: string;
+    status: RunStatusState;
+    progress: number;
+    error?: string;
+    finished?: boolean;
+    summary?: string;
+    commits?: Array<{
+        sha: string;
+        branch: string;
+        message: string;
+    }>;
+}
+/** Result of cancel. */
+export interface CancelRunResult {
+    success: boolean;
+    error?: string;
+}
+/** Harvested run memory (entries + learnings with provenance). */
+export interface ClientHarvestResult {
+    entries: Array<{
+        key?: string;
+        value: string;
+        metadata?: Record<string, unknown>;
+    }>;
+    learnings: RunLearning[];
+}
+/** Generic orchestration client interface. */
+export interface OrchestrationClient {
+    startRun(input: StartRunInput): Promise<{
+        runId: string;
+    }>;
+    getStatus(runId: string): Promise<ClientRunStatus>;
+    cancel(runId: string): Promise<CancelRunResult>;
+    /** Seed run-scoped memory before or during a run. */
+    seed(runId: string, entries: Array<{
+        key?: string;
+        value: string;
+        metadata?: Record<string, unknown>;
+    }>): Promise<void>;
+    /** Record a learning/pattern for the run (included in harvest). */
+    recordLearning(runId: string, learning: string, score?: number, provenance?: Record<string, unknown>): Promise<void>;
+    /** Search memory (run-scoped or global). */
+    search(scope: MemorySearchScope | {
+        runId?: string;
+    }, query: string, topK: number): Promise<MemorySearchResult[]>;
+    /** Harvest run-scoped entries and learnings after a run (for audit/reuse). */
+    harvest(runId: string): Promise<ClientHarvestResult>;
+}
+export interface CreateOrchestrationClientOptions {
+    /** Orchestrator config (e.g. backend: 'safe-exec' | 'test'). */
+    config?: OrchestratorConfig;
+}
+/**
+ * Create a generic orchestration client. Use this when your app needs a stable
+ * input/output shape (taskDescription, memorySeed, acceptanceCriteria, paths,
+ * provenance) and runId/status/cancel results. Map your app payload to
+ * StartRunInput; use the returned runId for getStatus and cancel.
+ */
+export declare function createOrchestrationClient(options?: CreateOrchestrationClientOptions): OrchestrationClient;
+//# sourceMappingURL=orchestration-client.d.ts.map

package/dist/agentic-flow/src/orchestration/orchestration-client.d.ts.map

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

package/dist/agentic-flow/src/orchestration/orchestration-client.js

@@ -0,0 +1,94 @@
+/**
+ * Generic orchestration client (Option A).
+ *
+ * Stable input/output shape for apps (build systems, IDEs, CI) that drive
+ * agentic-flow in-process. Map your app payload to StartRunInput; get back
+ * runId and a consistent status/cancel result shape.
+ */
+import { createOrchestrator, getRunStatus, cancelRun, getRunArtifacts, } from './orchestration-runtime.js';
+import { seedMemory, recordLearning, searchMemory, harvestMemory, } from './memory-plane.js';
+function phaseToState(phase) {
+    switch (phase) {
+        case 'pending':
+            return 'queued';
+        case 'running':
+            return 'running';
+        case 'completed':
+            return 'completed';
+        case 'failed':
+            return 'failed';
+        case 'cancelled':
+            return 'cancelled';
+        case 'unknown':
+        default:
+            return 'unknown';
+    }
+}
+/**
+ * Create a generic orchestration client. Use this when your app needs a stable
+ * input/output shape (taskDescription, memorySeed, acceptanceCriteria, paths,
+ * provenance) and runId/status/cancel results. Map your app payload to
+ * StartRunInput; use the returned runId for getStatus and cancel.
+ */
+export function createOrchestrationClient(options = {}) {
+    const { config = {} } = options;
+    const orchestrator = createOrchestrator(config);
+    return {
+        async startRun(input) {
+            const handle = await orchestrator.orchestrateTask({
+                description: input.taskDescription,
+                strategy: 'adaptive',
+                priority: 'medium',
+                initialMemoryEntries: input.memorySeed,
+                cwd: input.cwd,
+                acceptanceCriteria: input.acceptanceCriteria,
+                allowedPaths: input.allowedPaths,
+                forbiddenPaths: input.forbiddenPaths,
+                provenance: input.provenance,
+                loopPolicy: input.loopPolicy,
+            });
+            return { runId: handle.runId };
+        },
+        async getStatus(runId) {
+            const status = await getRunStatus(runId);
+            const artifacts = await getRunArtifacts(runId);
+            const commits = (artifacts.commits ?? []).map((c) => ({
+                sha: c.sha ?? '',
+                branch: '',
+                message: c.message ?? '',
+            }));
+            return {
+                runId,
+                status: phaseToState(status.phase),
+                progress: status.progress,
+                error: status.error,
+                finished: status.finished,
+                summary: status.finished ? `Progress: ${status.progress}%` : undefined,
+                commits: commits.length > 0 ? commits : undefined,
+            };
+        },
+        async cancel(runId) {
+            try {
+                await cancelRun(runId);
+                return { success: true };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return { success: false, error: message };
+            }
+        },
+        async seed(runId, entries) {
+            await seedMemory(runId, entries);
+        },
+        async recordLearning(runId, learning, score, provenance) {
+            await recordLearning(runId, learning, score, provenance);
+        },
+        async search(scope, query, topK) {
+            return searchMemory(scope, query, topK);
+        },
+        async harvest(runId) {
+            return harvestMemory(runId);
+        },
+    };
+}
+//# sourceMappingURL=orchestration-client.js.map

package/dist/agentic-flow/src/orchestration/orchestration-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-client.js","sourceRoot":"","sources":["../../../../src/orchestration/orchestration-client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Generic orchestration client (Option A).\n *\n * Stable input/output shape for apps (build systems, IDEs, CI) that drive\n * agentic-flow in-process. Map your app payload to StartRunInput; get back\n * runId and a consistent status/cancel result shape.\n */\n\nimport {\n  createOrchestrator,\n  getRunStatus,\n  cancelRun,\n  getRunArtifacts,\n} from './orchestration-runtime.js';\nimport type {\n  OrchestratorConfig,\n  RunPhase,\n  LoopPolicy,\n} from './orchestration-types.js';\nimport {\n  seedMemory,\n  recordLearning,\n  searchMemory,\n  harvestMemory,\n} from './memory-plane.js';\nimport type { MemorySearchScope } from './memory-plane-types.js';\nimport type { MemorySearchResult } from './memory-plane-types.js';\nimport type { RunLearning } from './memory-plane.js';\n\n/** Generic input for starting a run. Apps map their payload to this shape. */\nexport interface StartRunInput {\n  /** Full task description for the build agent. */\n  taskDescription: string;\n  /** Working directory for the run. */\n  cwd?: string;\n  /** Memory entries to seed before the run (e.g. context refs). */\n  memorySeed?: Array<{\n    key: string;\n    value: string;\n    namespace?: string;\n    metadata?: Record<string, unknown>;\n  }>;\n  /** Acceptance criteria (e.g. \"tests pass\", \"lint clean\"). */\n  acceptanceCriteria?: string[];\n  /** Paths the run is allowed to modify. */\n  allowedPaths?: string[];\n  /** Paths the run must not modify. */\n  forbiddenPaths?: string[];\n  /** Provenance (run/card/assignment ids) for audit. */\n  provenance?: { runId?: string; assignmentId?: string; cardId?: string; [key: string]: unknown };\n  /** Loop policy: max iterations, success criteria, retry, budget. Pass-through for backends. */\n  loopPolicy?: LoopPolicy;\n}\n\n/** Status state returned by the generic client. */\nexport type RunStatusState =\n  | 'queued'\n  | 'running'\n  | 'completed'\n  | 'failed'\n  | 'cancelled'\n  | 'unknown';\n\n/** Generic run status. Apps map this to their own status type if needed. */\nexport interface ClientRunStatus {\n  runId: string;\n  status: RunStatusState;\n  progress: number;\n  error?: string;\n  finished?: boolean;\n  summary?: string;\n  commits?: Array<{ sha: string; branch: string; message: string }>;\n}\n\n/** Result of cancel. */\nexport interface CancelRunResult {\n  success: boolean;\n  error?: string;\n}\n\n/** Harvested run memory (entries + learnings with provenance). */\nexport interface ClientHarvestResult {\n  entries: Array<{ key?: string; value: string; metadata?: Record<string, unknown> }>;\n  learnings: RunLearning[];\n}\n\n/** Generic orchestration client interface. */\nexport interface OrchestrationClient {\n  startRun(input: StartRunInput): Promise<{ runId: string }>;\n  getStatus(runId: string): Promise<ClientRunStatus>;\n  cancel(runId: string): Promise<CancelRunResult>;\n  /** Seed run-scoped memory before or during a run. */\n  seed(runId: string, entries: Array<{ key?: string; value: string; metadata?: Record<string, unknown> }>): Promise<void>;\n  /** Record a learning/pattern for the run (included in harvest). */\n  recordLearning(\n    runId: string,\n    learning: string,\n    score?: number,\n    provenance?: Record<string, unknown>\n  ): Promise<void>;\n  /** Search memory (run-scoped or global). */\n  search(scope: MemorySearchScope | { runId?: string }, query: string, topK: number): Promise<MemorySearchResult[]>;\n  /** Harvest run-scoped entries and learnings after a run (for audit/reuse). */\n  harvest(runId: string): Promise<ClientHarvestResult>;\n}\n\nfunction phaseToState(phase: RunPhase): RunStatusState {\n  switch (phase) {\n    case 'pending':\n      return 'queued';\n    case 'running':\n      return 'running';\n    case 'completed':\n      return 'completed';\n    case 'failed':\n      return 'failed';\n    case 'cancelled':\n      return 'cancelled';\n    case 'unknown':\n    default:\n      return 'unknown';\n  }\n}\n\nexport interface CreateOrchestrationClientOptions {\n  /** Orchestrator config (e.g. backend: 'safe-exec' | 'test'). */\n  config?: OrchestratorConfig;\n}\n\n/**\n * Create a generic orchestration client. Use this when your app needs a stable\n * input/output shape (taskDescription, memorySeed, acceptanceCriteria, paths,\n * provenance) and runId/status/cancel results. Map your app payload to\n * StartRunInput; use the returned runId for getStatus and cancel.\n */\nexport function createOrchestrationClient(\n  options: CreateOrchestrationClientOptions = {}\n): OrchestrationClient {\n  const { config = {} } = options;\n  const orchestrator = createOrchestrator(config);\n\n  return {\n    async startRun(input: StartRunInput) {\n      const handle = await orchestrator.orchestrateTask({\n        description: input.taskDescription,\n        strategy: 'adaptive',\n        priority: 'medium',\n        initialMemoryEntries: input.memorySeed,\n        cwd: input.cwd,\n        acceptanceCriteria: input.acceptanceCriteria,\n        allowedPaths: input.allowedPaths,\n        forbiddenPaths: input.forbiddenPaths,\n        provenance: input.provenance,\n        loopPolicy: input.loopPolicy,\n      });\n      return { runId: handle.runId };\n    },\n\n    async getStatus(runId: string): Promise<ClientRunStatus> {\n      const status = await getRunStatus(runId);\n      const artifacts = await getRunArtifacts(runId);\n      const commits = (artifacts.commits ?? []).map((c) => ({\n        sha: c.sha ?? '',\n        branch: '',\n        message: c.message ?? '',\n      }));\n\n      return {\n        runId,\n        status: phaseToState(status.phase),\n        progress: status.progress,\n        error: status.error,\n        finished: status.finished,\n        summary: status.finished ? `Progress: ${status.progress}%` : undefined,\n        commits: commits.length > 0 ? commits : undefined,\n      };\n    },\n\n    async cancel(runId: string): Promise<CancelRunResult> {\n      try {\n        await cancelRun(runId);\n        return { success: true };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return { success: false, error: message };\n      }\n    },\n\n    async seed(\n      runId: string,\n      entries: Array<{ key?: string; value: string; metadata?: Record<string, unknown> }>\n    ): Promise<void> {\n      await seedMemory(runId, entries);\n    },\n\n    async recordLearning(\n      runId: string,\n      learning: string,\n      score?: number,\n      provenance?: Record<string, unknown>\n    ): Promise<void> {\n      await recordLearning(runId, learning, score, provenance);\n    },\n\n    async search(\n      scope: MemorySearchScope | { runId?: string },\n      query: string,\n      topK: number\n    ): Promise<MemorySearchResult[]> {\n      return searchMemory(scope, query, topK);\n    },\n\n    async harvest(runId: string): Promise<ClientHarvestResult> {\n      return harvestMemory(runId);\n    },\n  };\n}\n"]}

package/dist/agentic-flow/src/orchestration/orchestration-runtime.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Orchestration Runtime - Implementation (PR1)
+ *
+ * Delegates to existing safe-exec path; run lifecycle stored in-memory.
+ */
+import type { OrchestratorConfig, RunHandle, RunStatus, RunArtifacts, OrchestrateTaskInput } from './orchestration-types.js';
+export interface Orchestrator {
+    orchestrateTask(input: OrchestrateTaskInput): Promise<RunHandle>;
+}
+/**
+ * Create an orchestrator instance.
+ */
+export declare function createOrchestrator(config?: OrchestratorConfig): Orchestrator;
+/**
+ * Get status for a run.
+ */
+export declare function getRunStatus(runId: string): Promise<RunStatus>;
+/**
+ * Best-effort cancel of a run. No-op when backend does not support cancel.
+ */
+export declare function cancelRun(_runId: string): Promise<void>;
+/**
+ * Get artifacts for a run.
+ */
+export declare function getRunArtifacts(runId: string): Promise<RunArtifacts>;
+//# sourceMappingURL=orchestration-runtime.d.ts.map

package/dist/agentic-flow/src/orchestration/orchestration-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-runtime.d.ts","sourceRoot":"","sources":["../../../../src/orchestration/orchestration-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACV,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,YAAY,EACZ,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAYlC,MAAM,WAAW,YAAY;IAC3B,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAClE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,kBAAuB,GAAG,YAAY,CAwChF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAIpE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAI1E"}

package/dist/agentic-flow/src/orchestration/orchestration-runtime.js

@@ -0,0 +1,78 @@
+/**
+ * Orchestration Runtime - Implementation (PR1)
+ *
+ * Delegates to existing safe-exec path; run lifecycle stored in-memory.
+ */
+import { ulid } from 'ulid';
+import { seedMemory } from './memory-plane.js';
+const defaultConfig = {
+    backend: 'safe-exec',
+};
+/** In-memory run store: runId -> RunStatus. */
+const runStatusStore = new Map();
+/** In-memory artifacts store: runId -> RunArtifacts. */
+const runArtifactsStore = new Map();
+/**
+ * Create an orchestrator instance.
+ */
+export function createOrchestrator(config = {}) {
+    const { backend } = { ...defaultConfig, ...config };
+    return {
+        async orchestrateTask(input) {
+            const runId = ulid();
+            runStatusStore.set(runId, { phase: 'running', progress: 0, finished: false });
+            if (input.initialMemoryEntries?.length) {
+                await seedMemory(runId, input.initialMemoryEntries);
+            }
+            try {
+                // Backend execution is mocked for now
+                // TODO: Implement safe-exec backend when needed
+                // Safe-exec module not yet implemented, using mock execution
+                if (backend === 'safe-exec') {
+                    console.warn('safe-exec backend not available, using mock execution');
+                }
+                runStatusStore.set(runId, { phase: 'completed', progress: 100, finished: true });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                runStatusStore.set(runId, {
+                    phase: 'failed',
+                    progress: 100,
+                    error: message,
+                    finished: true,
+                });
+            }
+            runArtifactsStore.set(runId, {
+                commits: [],
+                testLogs: [],
+                memoryWrites: [],
+            });
+            return { runId };
+        },
+    };
+}
+/**
+ * Get status for a run.
+ */
+export async function getRunStatus(runId) {
+    const status = runStatusStore.get(runId);
+    if (status)
+        return status;
+    return { phase: 'unknown', progress: 0, finished: false };
+}
+/**
+ * Best-effort cancel of a run. No-op when backend does not support cancel.
+ */
+export async function cancelRun(_runId) {
+    // P2P and safe-exec backends do not support cancel today.
+}
+/**
+ * Get artifacts for a run.
+ */
+export async function getRunArtifacts(runId) {
+    const artifacts = runArtifactsStore.get(runId);
+    if (artifacts)
+        return artifacts;
+    return { commits: [], testLogs: [], memoryWrites: [] };
+}
+//# sourceMappingURL=orchestration-runtime.js.map

package/dist/agentic-flow/src/orchestration/orchestration-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-runtime.js","sourceRoot":"","sources":["../../../../src/orchestration/orchestration-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAS/C,MAAM,aAAa,GAAkD;IACnE,OAAO,EAAE,WAAW;CACrB,CAAC;AAEF,+CAA+C;AAC/C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAqB,CAAC;AAEpD,wDAAwD;AACxD,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAwB,CAAC;AAM1D;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA6B,EAAE;IAChE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,MAAM,EAAE,CAAC;IAEpD,OAAO;QACL,KAAK,CAAC,eAAe,CAAC,KAA2B;YAC/C,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;YACrB,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YAE9E,IAAI,KAAK,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAC;gBACvC,MAAM,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACtD,CAAC;YAED,IAAI,CAAC;gBACH,sCAAsC;gBACtC,gDAAgD;gBAChD,6DAA6D;gBAC7D,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;oBAC5B,OAAO,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;gBACxE,CAAC;gBAED,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACnF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE;oBACxB,KAAK,EAAE,QAAQ;oBACf,QAAQ,EAAE,GAAG;oBACb,KAAK,EAAE,OAAO;oBACd,QAAQ,EAAE,IAAI;iBACf,CAAC,CAAC;YACL,CAAC;YAED,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE;gBAC3B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,EAAE;gBACZ,YAAY,EAAE,EAAE;aACjB,CAAC,CAAC;YAEH,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAa;IAC9C,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAc;IAC5C,0DAA0D;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAa;IACjD,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;AACzD,CAAC","sourcesContent":["/**\n * Orchestration Runtime - Implementation (PR1)\n *\n * Delegates to existing safe-exec path; run lifecycle stored in-memory.\n */\n\nimport { ulid } from 'ulid';\nimport { seedMemory } from './memory-plane.js';\nimport type {\n  OrchestratorConfig,\n  RunHandle,\n  RunStatus,\n  RunArtifacts,\n  OrchestrateTaskInput,\n} from './orchestration-types.js';\n\nconst defaultConfig: Required<Pick<OrchestratorConfig, 'backend'>> = {\n  backend: 'safe-exec',\n};\n\n/** In-memory run store: runId -> RunStatus. */\nconst runStatusStore = new Map<string, RunStatus>();\n\n/** In-memory artifacts store: runId -> RunArtifacts. */\nconst runArtifactsStore = new Map<string, RunArtifacts>();\n\nexport interface Orchestrator {\n  orchestrateTask(input: OrchestrateTaskInput): Promise<RunHandle>;\n}\n\n/**\n * Create an orchestrator instance.\n */\nexport function createOrchestrator(config: OrchestratorConfig = {}): Orchestrator {\n  const { backend } = { ...defaultConfig, ...config };\n\n  return {\n    async orchestrateTask(input: OrchestrateTaskInput): Promise<RunHandle> {\n      const runId = ulid();\n      runStatusStore.set(runId, { phase: 'running', progress: 0, finished: false });\n\n      if (input.initialMemoryEntries?.length) {\n        await seedMemory(runId, input.initialMemoryEntries);\n      }\n\n      try {\n        // Backend execution is mocked for now\n        // TODO: Implement safe-exec backend when needed\n        // Safe-exec module not yet implemented, using mock execution\n        if (backend === 'safe-exec') {\n          console.warn('safe-exec backend not available, using mock execution');\n        }\n\n        runStatusStore.set(runId, { phase: 'completed', progress: 100, finished: true });\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        runStatusStore.set(runId, {\n          phase: 'failed',\n          progress: 100,\n          error: message,\n          finished: true,\n        });\n      }\n\n      runArtifactsStore.set(runId, {\n        commits: [],\n        testLogs: [],\n        memoryWrites: [],\n      });\n\n      return { runId };\n    },\n  };\n}\n\n/**\n * Get status for a run.\n */\nexport async function getRunStatus(runId: string): Promise<RunStatus> {\n  const status = runStatusStore.get(runId);\n  if (status) return status;\n  return { phase: 'unknown', progress: 0, finished: false };\n}\n\n/**\n * Best-effort cancel of a run. No-op when backend does not support cancel.\n */\nexport async function cancelRun(_runId: string): Promise<void> {\n  // P2P and safe-exec backends do not support cancel today.\n}\n\n/**\n * Get artifacts for a run.\n */\nexport async function getRunArtifacts(runId: string): Promise<RunArtifacts> {\n  const artifacts = runArtifactsStore.get(runId);\n  if (artifacts) return artifacts;\n  return { commits: [], testLogs: [], memoryWrites: [] };\n}\n"]}