@rasensio/aidlc 0.1.0

package/dist/events/plugin-hooks.js.map

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

package/dist/orchestrator/budget-packer.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Context budget packer for orchestrator mode.
+ *
+ * Greedy priority-first algorithm that packs context items into a token budget.
+ * When a full item doesn't fit, the packer tries its summary (Artifact_Summary)
+ * before excluding it entirely.
+ *
+ * Requirements: 19.4, 19.5, 25.7, 25.8
+ */
+/** A context item to be considered for inclusion in a prompt. */
+export interface ContextItem {
+    /** Unique identifier for this item. */
+    id: string;
+    /** Full content of this item. */
+    content: string;
+    /** Priority 1-100, higher = more important. */
+    priority: number;
+    /** Estimated token count for the full content. */
+    tokenEstimate: number;
+    /** Optional shorter summary version (used when full content doesn't fit). */
+    summary?: string;
+}
+/** Result of packing context items into a budget. */
+export interface PackResult {
+    /** Items that fit in the budget (may use summary version). */
+    included: ContextItem[];
+    /** Items that didn't fit even as summaries. */
+    excluded: ContextItem[];
+    /** Total tokens used by included items. */
+    totalTokens: number;
+    /** IDs of items where the summary was used instead of full content. */
+    usedSummary: string[];
+}
+/**
+ * Estimate the token count of a text string.
+ *
+ * Uses the simple heuristic of ~4 characters per token.
+ * This is a rough approximation suitable for budget planning.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Pack context items into a token budget using a greedy priority-first algorithm.
+ *
+ * Algorithm:
+ * 1. Sort items by priority descending (stable sort preserves insertion order for ties)
+ * 2. For each item (highest priority first):
+ *    a. If full content fits in remaining budget → include it
+ *    b. Else if summary exists and fits → include summary version
+ *    c. Else → exclude
+ * 3. Return PackResult
+ *
+ * @param items - Context items to pack.
+ * @param budgetTokens - Maximum token count for the packed result.
+ * @returns PackResult describing which items were included/excluded.
+ */
+export declare function packContext(items: ContextItem[], budgetTokens: number): PackResult;
+//# sourceMappingURL=budget-packer.d.ts.map

package/dist/orchestrator/budget-packer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-packer.d.ts","sourceRoot":"","sources":["../../src/orchestrator/budget-packer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,8DAA8D;IAC9D,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,UAAU,CAmClF"}

package/dist/orchestrator/budget-packer.js

@@ -0,0 +1,70 @@
+/**
+ * Context budget packer for orchestrator mode.
+ *
+ * Greedy priority-first algorithm that packs context items into a token budget.
+ * When a full item doesn't fit, the packer tries its summary (Artifact_Summary)
+ * before excluding it entirely.
+ *
+ * Requirements: 19.4, 19.5, 25.7, 25.8
+ */
+// ---------------------------------------------------------------------------
+// Token Estimation
+// ---------------------------------------------------------------------------
+/**
+ * Estimate the token count of a text string.
+ *
+ * Uses the simple heuristic of ~4 characters per token.
+ * This is a rough approximation suitable for budget planning.
+ */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+// ---------------------------------------------------------------------------
+// Budget Packer
+// ---------------------------------------------------------------------------
+/**
+ * Pack context items into a token budget using a greedy priority-first algorithm.
+ *
+ * Algorithm:
+ * 1. Sort items by priority descending (stable sort preserves insertion order for ties)
+ * 2. For each item (highest priority first):
+ *    a. If full content fits in remaining budget → include it
+ *    b. Else if summary exists and fits → include summary version
+ *    c. Else → exclude
+ * 3. Return PackResult
+ *
+ * @param items - Context items to pack.
+ * @param budgetTokens - Maximum token count for the packed result.
+ * @returns PackResult describing which items were included/excluded.
+ */
+export function packContext(items, budgetTokens) {
+    // Sort by priority descending; stable sort preserves order for equal priorities
+    const sorted = [...items].sort((a, b) => b.priority - a.priority);
+    const included = [];
+    const excluded = [];
+    const usedSummary = [];
+    let totalTokens = 0;
+    for (const item of sorted) {
+        const remaining = budgetTokens - totalTokens;
+        // Try full content first
+        if (item.tokenEstimate <= remaining) {
+            included.push(item);
+            totalTokens += item.tokenEstimate;
+            continue;
+        }
+        // Try summary if available
+        if (item.summary !== undefined) {
+            const summaryTokens = estimateTokens(item.summary);
+            if (summaryTokens <= remaining) {
+                included.push(item);
+                totalTokens += summaryTokens;
+                usedSummary.push(item.id);
+                continue;
+            }
+        }
+        // Doesn't fit at all
+        excluded.push(item);
+    }
+    return { included, excluded, totalTokens, usedSummary };
+}
+//# sourceMappingURL=budget-packer.js.map

package/dist/orchestrator/budget-packer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-packer.js","sourceRoot":"","sources":["../../src/orchestrator/budget-packer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgCH,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CAAC,KAAoB,EAAE,YAAoB;IACpE,gFAAgF;IAChF,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAElE,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC;QAE7C,yBAAyB;QACzB,IAAI,IAAI,CAAC,aAAa,IAAI,SAAS,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,WAAW,IAAI,IAAI,CAAC,aAAa,CAAC;YAClC,SAAS;QACX,CAAC;QAED,2BAA2B;QAC3B,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACnD,IAAI,aAAa,IAAI,SAAS,EAAE,CAAC;gBAC/B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpB,WAAW,IAAI,aAAa,CAAC;gBAC7B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC1B,SAAS;YACX,CAAC;QACH,CAAC;QAED,qBAAqB;QACrB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAC1D,CAAC"}

package/dist/orchestrator/config.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Orchestrator configuration loader and client factory.
+ *
+ * - `loadOrchestratorConfig()` reads orchestrator config from `.aidlc/config.yaml`.
+ * - `createClient()` creates an EndpointClient from an OrchestratorConfig.
+ * - `createClientFromFlags()` creates an EndpointClient from CLI flag values.
+ *
+ * Key constraint (Req 19.12): The orchestrator is strictly optional. All other
+ * AIDLC operations must work without any orchestrator config present.
+ *
+ * Requirements: 19.1, 19.3, 19.12
+ */
+import type { ApiFormat, EndpointClient, OrchestratorConfig } from '../core/types.js';
+/**
+ * Load the orchestrator section from a project config file.
+ *
+ * Returns `null` if:
+ * - The config file does not exist
+ * - The file is unreadable or invalid YAML
+ * - The `orchestrator` section is absent
+ *
+ * This ensures orchestrator remains optional (Req 19.12).
+ *
+ * @param configPath - Absolute path to the `.aidlc/config.yaml` file.
+ */
+export declare function loadOrchestratorConfig(configPath: string): OrchestratorConfig | null;
+/**
+ * Create an EndpointClient from an OrchestratorConfig.
+ *
+ * Selects the appropriate client implementation based on `config.api_format`.
+ */
+export declare function createClient(config: OrchestratorConfig): EndpointClient;
+/**
+ * Create an EndpointClient from CLI flags (--endpoint, --model, --api-format).
+ *
+ * CLI flags override config values per Req 19.3.
+ */
+export declare function createClientFromFlags(opts: {
+    endpoint: string;
+    model: string;
+    apiFormat: ApiFormat;
+}): EndpointClient;
+//# sourceMappingURL=config.d.ts.map

package/dist/orchestrator/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/orchestrator/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAOtF;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAsDpF;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAOvE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,SAAS,CAAC;CACtB,GAAG,cAAc,CAOjB"}

package/dist/orchestrator/config.js

@@ -0,0 +1,109 @@
+/**
+ * Orchestrator configuration loader and client factory.
+ *
+ * - `loadOrchestratorConfig()` reads orchestrator config from `.aidlc/config.yaml`.
+ * - `createClient()` creates an EndpointClient from an OrchestratorConfig.
+ * - `createClientFromFlags()` creates an EndpointClient from CLI flag values.
+ *
+ * Key constraint (Req 19.12): The orchestrator is strictly optional. All other
+ * AIDLC operations must work without any orchestrator config present.
+ *
+ * Requirements: 19.1, 19.3, 19.12
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { parse as parseYaml } from 'yaml';
+import { createOllamaClient, createOpenAIClient } from './endpoint-clients.js';
+// ---------------------------------------------------------------------------
+// Config Loader
+// ---------------------------------------------------------------------------
+/**
+ * Load the orchestrator section from a project config file.
+ *
+ * Returns `null` if:
+ * - The config file does not exist
+ * - The file is unreadable or invalid YAML
+ * - The `orchestrator` section is absent
+ *
+ * This ensures orchestrator remains optional (Req 19.12).
+ *
+ * @param configPath - Absolute path to the `.aidlc/config.yaml` file.
+ */
+export function loadOrchestratorConfig(configPath) {
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    let raw;
+    try {
+        raw = readFileSync(configPath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch {
+        return null;
+    }
+    if (parsed === null || typeof parsed !== 'object') {
+        return null;
+    }
+    const doc = parsed;
+    const orch = doc.orchestrator;
+    if (!orch || typeof orch !== 'object') {
+        return null;
+    }
+    const orchObj = orch;
+    // Validate required fields
+    if (typeof orchObj.endpoint !== 'string' || orchObj.endpoint.length === 0) {
+        return null;
+    }
+    if (typeof orchObj.model !== 'string' || orchObj.model.length === 0) {
+        return null;
+    }
+    const apiFormat = orchObj.api_format;
+    if (apiFormat !== 'ollama' && apiFormat !== 'openai') {
+        return null;
+    }
+    return {
+        endpoint: orchObj.endpoint,
+        model: orchObj.model,
+        api_format: apiFormat,
+        review_model: typeof orchObj.review_model === 'string' ? orchObj.review_model : null,
+        auto_advance: orchObj.auto_advance === true,
+        context_budget_tokens: typeof orchObj.context_budget_tokens === 'number'
+            ? orchObj.context_budget_tokens
+            : 8192,
+    };
+}
+// ---------------------------------------------------------------------------
+// Client Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create an EndpointClient from an OrchestratorConfig.
+ *
+ * Selects the appropriate client implementation based on `config.api_format`.
+ */
+export function createClient(config) {
+    switch (config.api_format) {
+        case 'ollama':
+            return createOllamaClient(config.endpoint);
+        case 'openai':
+            return createOpenAIClient(config.endpoint);
+    }
+}
+/**
+ * Create an EndpointClient from CLI flags (--endpoint, --model, --api-format).
+ *
+ * CLI flags override config values per Req 19.3.
+ */
+export function createClientFromFlags(opts) {
+    switch (opts.apiFormat) {
+        case 'ollama':
+            return createOllamaClient(opts.endpoint);
+        case 'openai':
+            return createOpenAIClient(opts.endpoint);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/orchestrator/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/orchestrator/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE/E,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC;IAC9B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,IAA+B,CAAC;IAEhD,2BAA2B;IAC3B,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IACrC,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,SAAsB;QAClC,YAAY,EAAE,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI;QACpF,YAAY,EAAE,OAAO,CAAC,YAAY,KAAK,IAAI;QAC3C,qBAAqB,EAAE,OAAO,OAAO,CAAC,qBAAqB,KAAK,QAAQ;YACtE,CAAC,CAAC,OAAO,CAAC,qBAAqB;YAC/B,CAAC,CAAC,IAAI;KACT,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,QAAQ,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1B,KAAK,QAAQ;YACX,OAAO,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7C,KAAK,QAAQ;YACX,OAAO,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAIrC;IACC,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;QACvB,KAAK,QAAQ;YACX,OAAO,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3C,KAAK,QAAQ;YACX,OAAO,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/orchestrator/endpoint-clients.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Endpoint clients for orchestrator mode.
+ *
+ * Implements the EndpointClient interface for:
+ * - Ollama native API (POST <endpoint>/api/chat)
+ * - OpenAI-compatible API (POST <endpoint>/v1/chat/completions)
+ *
+ * Requirements: 19.1, 19.2
+ */
+import type { EndpointClient } from '../core/types.js';
+/**
+ * Create an EndpointClient that communicates with the Ollama native API.
+ *
+ * @param endpoint - Base URL of the Ollama server (e.g., "http://localhost:11434")
+ */
+export declare function createOllamaClient(endpoint: string): EndpointClient;
+/**
+ * Create an EndpointClient that communicates with an OpenAI-compatible API.
+ *
+ * @param endpoint - Base URL of the API server (e.g., "http://localhost:11434")
+ */
+export declare function createOpenAIClient(endpoint: string): EndpointClient;
+//# sourceMappingURL=endpoint-clients.d.ts.map

package/dist/orchestrator/endpoint-clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-clients.d.ts","sourceRoot":"","sources":["../../src/orchestrator/endpoint-clients.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAuC,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAoC5F;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAyBnE;AA2CD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAyBnE"}

package/dist/orchestrator/endpoint-clients.js

@@ -0,0 +1,129 @@
+/**
+ * Endpoint clients for orchestrator mode.
+ *
+ * Implements the EndpointClient interface for:
+ * - Ollama native API (POST <endpoint>/api/chat)
+ * - OpenAI-compatible API (POST <endpoint>/v1/chat/completions)
+ *
+ * Requirements: 19.1, 19.2
+ */
+// ---------------------------------------------------------------------------
+// Ollama Native Client
+// ---------------------------------------------------------------------------
+/**
+ * Build the request body for Ollama's native /api/chat endpoint.
+ */
+function buildOllamaBody(messages, opts) {
+    const body = {
+        model: opts.model,
+        messages,
+        stream: false,
+    };
+    if (opts.temperature !== undefined) {
+        body.options = { temperature: opts.temperature };
+    }
+    return JSON.stringify(body);
+}
+/**
+ * Parse Ollama's native /api/chat response to extract the assistant message content.
+ */
+function parseOllamaResponse(data) {
+    const obj = data;
+    const message = obj.message;
+    if (!message || typeof message.content !== 'string') {
+        throw new Error('Invalid Ollama response: missing message.content');
+    }
+    return {
+        content: message.content,
+        finish_reason: typeof obj.done_reason === 'string' ? obj.done_reason : undefined,
+    };
+}
+/**
+ * Create an EndpointClient that communicates with the Ollama native API.
+ *
+ * @param endpoint - Base URL of the Ollama server (e.g., "http://localhost:11434")
+ */
+export function createOllamaClient(endpoint) {
+    const baseUrl = endpoint.replace(/\/+$/, '');
+    return {
+        async chat(messages, opts) {
+            const url = `${baseUrl}/api/chat`;
+            const body = buildOllamaBody(messages, opts);
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body,
+            });
+            if (!response.ok) {
+                const text = await response.text().catch(() => '');
+                throw new Error(`Ollama endpoint error: ${response.status} ${response.statusText}${text ? ` — ${text}` : ''}`);
+            }
+            const data = await response.json();
+            return parseOllamaResponse(data);
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// OpenAI-Compatible Client
+// ---------------------------------------------------------------------------
+/**
+ * Build the request body for OpenAI-compatible /v1/chat/completions endpoint.
+ */
+function buildOpenAIBody(messages, opts) {
+    const body = {
+        model: opts.model,
+        messages,
+    };
+    if (opts.temperature !== undefined) {
+        body.temperature = opts.temperature;
+    }
+    if (opts.max_tokens !== undefined) {
+        body.max_tokens = opts.max_tokens;
+    }
+    return JSON.stringify(body);
+}
+/**
+ * Parse OpenAI-compatible /v1/chat/completions response.
+ */
+function parseOpenAIResponse(data) {
+    const obj = data;
+    const choices = obj.choices;
+    if (!choices || choices.length === 0) {
+        throw new Error('Invalid OpenAI response: missing choices array');
+    }
+    const first = choices[0];
+    const message = first.message;
+    if (!message || typeof message.content !== 'string') {
+        throw new Error('Invalid OpenAI response: missing choices[0].message.content');
+    }
+    return {
+        content: message.content,
+        finish_reason: typeof first.finish_reason === 'string' ? first.finish_reason : undefined,
+    };
+}
+/**
+ * Create an EndpointClient that communicates with an OpenAI-compatible API.
+ *
+ * @param endpoint - Base URL of the API server (e.g., "http://localhost:11434")
+ */
+export function createOpenAIClient(endpoint) {
+    const baseUrl = endpoint.replace(/\/+$/, '');
+    return {
+        async chat(messages, opts) {
+            const url = `${baseUrl}/v1/chat/completions`;
+            const body = buildOpenAIBody(messages, opts);
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body,
+            });
+            if (!response.ok) {
+                const text = await response.text().catch(() => '');
+                throw new Error(`OpenAI endpoint error: ${response.status} ${response.statusText}${text ? ` — ${text}` : ''}`);
+            }
+            const data = await response.json();
+            return parseOpenAIResponse(data);
+        },
+    };
+}
+//# sourceMappingURL=endpoint-clients.js.map

package/dist/orchestrator/endpoint-clients.js.map

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

package/dist/orchestrator/orchestrator-loop.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Orchestrator loop — drives a lifecycle instance through phases via a bare LLM endpoint.
+ *
+ * This module is optional (Req 19.12). It imports endpoint-clients and budget-packer
+ * but does NOT import into the CLI unless the `aidlc run` command is invoked.
+ *
+ * Loop:
+ * 1. Load instance state, resolve template, compute nextStep
+ * 2. Pack context items into the budget using packContext
+ * 3. Build the prompt (system message + context + task)
+ * 4. Call the LLM endpoint
+ * 5. Process the response (log; artifact processing is a future enhancement)
+ * 6. If autoAdvance, attempt transition
+ * 7. Repeat until complete or maxIterations reached
+ *
+ * Requirements: 19.1, 19.6, 19.12
+ */
+import type { EndpointClient, InstanceState, PhaseState, WorkflowTemplate, NextStep } from '../core/types.js';
+import type { ContextItem, PackResult } from './budget-packer.js';
+/** Options for running the orchestrator loop. */
+export interface OrchestratorOpts {
+    /** Lifecycle instance name. */
+    instance: string;
+    /** Endpoint client for LLM communication. */
+    client: EndpointClient;
+    /** Model name to pass to the endpoint. */
+    model: string;
+    /** Token budget for context packing per prompt. */
+    contextBudget: number;
+    /** If true, automatically attempt transition after response. */
+    autoAdvance: boolean;
+    /** Safety cap on iterations (default 50). */
+    maxIterations?: number;
+}
+/** Result returned when the orchestrator loop completes. */
+export interface OrchestratorResult {
+    /** Number of iterations executed. */
+    iterations: number;
+    /** Phase the instance is in when the loop ended. */
+    finalPhase: string;
+    /** Whether the lifecycle instance reached completion. */
+    completed: boolean;
+    /** Error message if the loop ended due to an error. */
+    error?: string;
+}
+/**
+ * Context loader interface — abstracts state and file reading so the loop
+ * doesn't need direct filesystem access (enables testing without I/O).
+ */
+export interface ContextLoader {
+    /** Load the instance state from the state store. */
+    loadInstanceState(instance: string): InstanceState;
+    /** Load all phase states for an instance. */
+    loadPhaseStates(instance: string): Map<string, PhaseState>;
+    /** Load and resolve the workflow template for an instance. */
+    loadTemplate(templateName: string): WorkflowTemplate;
+    /** Load the skill content for a given phase. Returns null if not found. */
+    loadPhaseSkill(phase: string): string | null;
+    /** Load context items (guidance, context docs, state summaries). */
+    loadContextItems(instance: string, phase: string): ContextItem[];
+    /** Record that the loop produced a response (placeholder for artifact processing). */
+    processResponse(instance: string, phase: string, response: string): void;
+    /**
+     * Attempt a phase transition after the loop determines it should advance.
+     * Returns the new phase name on success, or null if blocked.
+     */
+    attemptTransition(instance: string, currentPhase: string): string | null;
+}
+/**
+ * Build the system prompt from the current phase skill.
+ *
+ * The skill body forms the system message. If no skill is found, this is
+ * a hard error (Req 19.5) — callers must handle null skill before calling.
+ */
+export declare function buildSystemPrompt(skillContent: string, phase: string): string;
+/**
+ * Build the user message from packed context and the current task.
+ */
+export declare function buildUserMessage(packResult: PackResult, step: NextStep, instanceName: string): string;
+/**
+ * Run the orchestrator loop for a lifecycle instance.
+ *
+ * The loop repeats until:
+ * - The lifecycle instance reaches completion (nextStep returns 'complete')
+ * - maxIterations is reached (safety cap)
+ * - An error occurs (endpoint failure, missing skill, etc.)
+ *
+ * @param opts - Orchestrator configuration and endpoint client.
+ * @param loader - Context loader for state, templates, and files.
+ * @returns OrchestratorResult describing the outcome.
+ */
+export declare function runOrchestratorLoop(opts: OrchestratorOpts, loader: ContextLoader): Promise<OrchestratorResult>;
+//# sourceMappingURL=orchestrator-loop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-loop.d.ts","sourceRoot":"","sources":["../../src/orchestrator/orchestrator-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAEV,cAAc,EACd,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACT,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMlE,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,EAAE,cAAc,CAAC;IACvB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,WAAW,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC;IACnD,6CAA6C;IAC7C,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC3D,8DAA8D;IAC9D,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACrD,2EAA2E;IAC3E,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7C,oEAAoE;IACpE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IACjE,sFAAsF;IACtF,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACzE;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC1E;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,QAAQ,EACd,YAAY,EAAE,MAAM,GACnB,MAAM,CAmCR;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,kBAAkB,CAAC,CAmH7B"}