@mcoda/mswarm 0.1.57 → 0.1.61

package/dist/vendor/codali/cognitive/Prompts.js

@@ -0,0 +1,326 @@
+export const ARCHITECT_PROMPT = [
+    "ROLE: Technical Architect",
+    "TASK: Produce an implementation plan in plain text.",
+    "MODE: Plain-text planning only. Do NOT output JSON or DSL contracts.",
+    "REQUEST MORE DATA (PROTOCOL):",
+    "- If you are unsure or missing information, respond with an AGENT_REQUEST v1 block.",
+    "- If the RESEARCH SUMMARY shows missing evidence or gaps, request the missing data before planning.",
+    "- You can ask Codali to run Docdex tools (docdex.search, docdex.open, docdex.snippet, docdex.symbols, docdex.ast, docdex.impact, docdex.impact_diagnostics, docdex.tree, docdex.dag_export, docdex.web).",
+    "- You can also request file.read, file.list, or file.diff.",
+    "CONTEXT NOTES:",
+    "- Consult the REPO MEMORY and USER PROFILE sections in the context.",
+    "- Review the RESEARCH SUMMARY for tool usage, evidence gaps, and open questions.",
+    "- File contents are not included by default; request docdex.open or file.read when needed.",
+    "- Use focus files for concrete edits and treat periphery as read-only references.",
+    "- If required implementation files do not exist yet, explicitly plan to create them and include those new paths under CREATE FILES.",
+    "- In IMPLEMENTATION PLAN steps, include method/object-level responsibilities (what each function/module will do).",
+    "- For each existing file in FILES TO TOUCH, include at least one IMPLEMENTATION PLAN step naming that exact file and stating what will change there and what will be added there.",
+    "- Do not change requirements/specifications to avoid doing the requested work.",
+    "- Do NOT use generic filler lines (for example: \"review files\", \"apply changes\", \"run tests\") unless they also include concrete request nouns and exact targets.",
+    "- Every IMPLEMENTATION PLAN line must include request-specific nouns (feature/domain terms from the user request) and concrete implementation detail.",
+    "- Every VERIFY line must include request-specific nouns plus a concrete check target (file/module/route/endpoint/screen).",
+    "- FILES TO TOUCH must be concrete repo-relative paths. Do NOT output placeholders like \"path/to/file.ts\" or \"unknown\".",
+    "- RISK must reference concrete impacted behavior/components for this request; generic risk text is not allowed.",
+    "- If specificity is not possible from context, output AGENT_REQUEST v1 instead of generic plan text.",
+    "CONSTRAINTS:",
+    "- Do NOT output implementation code.",
+    "- Use only facts from the provided context bundle.",
+    "- Output plain text only (no JSON object contract required).",
+    "- Keep the plan concise, concrete, and implementation-ready.",
+    "- If a REVISION REQUIRED block is provided, revise the previous plan in-place; do not restart from scratch.",
+    "VALID OUTPUT EXAMPLE:",
+    "WHAT IS REQUIRED:",
+    "- Add uptime log writes for each health probe request.",
+    "CURRENT CONTEXT:",
+    "- Existing health probe handler lives in src/server/healthz.ts.",
+    "FOLDER STRUCTURE:",
+    "- src/server/healthz.ts",
+    "FILES TO TOUCH:",
+    "- src/server/healthz.ts",
+    "IMPLEMENTATION PLAN:",
+    "- Update src/server/healthz.ts to append uptime log writes for each health probe.",
+    "RISK: medium health endpoint latency may increase from sync file writes.",
+    "VERIFY:",
+    "- Run integration API test for /healthz and confirm uptime log file receives new entries.",
+    "INVALID OUTPUT EXAMPLE (DO NOT DO THIS):",
+    "- { \"query\": \"How do I implement healthz?\" }",
+    "- ```ts ... ```",
+    "- \"Review files and apply changes\"",
+    "PREFERRED OUTPUT SHAPE (PLAIN TEXT):",
+    "WHAT IS REQUIRED:",
+    "- <request requirement>",
+    "CURRENT CONTEXT:",
+    "- <relevant repo facts>",
+    "FOLDER STRUCTURE:",
+    "- <relevant folders/files>",
+    "FILES TO TOUCH:",
+    "- <path/to/file>",
+    "CREATE FILES:",
+    "- <path/to/new-file> (optional)",
+    "IMPLEMENTATION PLAN:",
+    "- <step 1>",
+    "- <step 2>",
+    "RISK: <low|medium|high> <brief reason>",
+    "VERIFY:",
+    "- <verification step>",
+].join("\n");
+export const ARCHITECT_GBNF = [
+    "root ::= ws \"PLAN:\" nl steps \"TARGETS:\" nl targets \"RISK:\" ws risk nl \"VERIFY:\" nl verify ws",
+    "steps ::= step+",
+    "step ::= ws \"-\" ws text nl",
+    "targets ::= target+",
+    "target ::= ws \"-\" ws text nl",
+    "verify ::= (ws \"-\" ws text nl)*",
+    "risk ::= text",
+    "text ::= [^\\n]+",
+    "ws ::= [ \\t]*",
+    "nl ::= \\\"\\\\n\\\" | \\\"\\\\r\\\\n\\\"",
+].join("\n");
+export const ARCHITECT_REVIEW_PROMPT = [
+    "ROLE: Technical Architect",
+    "TASK: Review the builder output against the plan and constraints.",
+    "REVIEW GOALS:",
+    "- Validate that builder output implements the USER REQUEST intent, not only plan formatting.",
+    "- If requested behavior is missing, only partially implemented, or replaced with unrelated/static content, return RETRY.",
+    "- Keep feedback concrete and file/behavior specific.",
+    "CONSTRAINTS:",
+    "- Do NOT output implementation code.",
+    "- Output plain text only (no JSON, no markdown).",
+    "OUTPUT FORMAT (PLAIN TEXT):",
+    "STATUS: PASS|RETRY",
+    "REASONS:",
+    "- <why PASS/RETRY based on request + plan + builder output evidence>",
+    "FEEDBACK:",
+    "- <actionable fixes if RETRY; optional when PASS>",
+].join("\n");
+export const ARCHITECT_REVIEW_GBNF = [
+    "root ::= ws \"REVIEW:\" nl \"STATUS:\" ws status nl \"REASONS:\" nl reasons \"FEEDBACK:\" nl feedback ws",
+    "status ::= \"PASS\" | \"RETRY\"",
+    "reasons ::= (ws \"-\" ws text nl)*",
+    "feedback ::= (ws \"-\" ws text nl)*",
+    "text ::= [^\\n]+",
+    "ws ::= [ \\t]*",
+    "nl ::= \\\"\\\\n\\\" | \\\"\\\\r\\\\n\\\"",
+].join("\n");
+export const ARCHITECT_VALIDATE_PROMPT = [
+    "ROLE: Technical Architect",
+    "TASK: Validate the PROPOSED PLAN against the context and constraints.",
+    "CONSTRAINTS:",
+    "- Reject generic/filler plan lines and generic risk text; keep request-specific nouns and concrete details.",
+    "- Ensure every IMPLEMENTATION PLAN and VERIFY line includes request-specific nouns and concrete targets/checks.",
+    "- Ensure FILES TO TOUCH are concrete repo-relative paths (no placeholders or \"unknown\").",
+    "- Do NOT output implementation code.",
+    "- If the plan is valid, output the EXACT plan as provided in plain-text sections.",
+    "- If the plan is invalid or incomplete, output a CORRECTED plan in plain-text sections.",
+    "- Use the same section format as the proposed plan.",
+    "OUTPUT FORMAT (PLAIN TEXT):",
+    "WHAT IS REQUIRED:",
+    "- <request requirement>",
+    "CURRENT CONTEXT:",
+    "- <context facts>",
+    "FOLDER STRUCTURE:",
+    "- <relevant folders/files>",
+    "FILES TO TOUCH:",
+    "- <path/to/file>",
+    "CREATE FILES:",
+    "- <path/to/new-file> (optional)",
+    "IMPLEMENTATION PLAN:",
+    "- <step 1>",
+    "- <step 2>",
+    "RISK: <low|medium|high> <brief reason>",
+    "VERIFY:",
+    "- <verification step>",
+].join("\n");
+export const ARCHITECT_VALIDATE_GBNF = ARCHITECT_GBNF;
+export const BUILDER_PATCH_GBNF_SEARCH_REPLACE = [
+    "root ::= ws object ws",
+    "object ::= \"{\" ws \\\"\\\"patches\\\"\\\" ws \":\" ws patch_array ws \"}\"",
+    "patch_array ::= \"[\" ws patch (ws \",\" ws patch)* ws \"]\"",
+    "patch ::= replace | create | delete",
+    "replace ::= \"{\" ws \\\"\\\"action\\\"\\\" ws \":\" ws \\\"\\\"replace\\\"\\\" ws \",\" ws \\\"\\\"file\\\"\\\" ws \":\" ws string ws \",\" ws \\\"\\\"search_block\\\"\\\" ws \":\" ws string ws \",\" ws \\\"\\\"replace_block\\\"\\\" ws \":\" ws string ws \"}\"",
+    "create ::= \"{\" ws \\\"\\\"action\\\"\\\" ws \":\" ws \\\"\\\"create\\\"\\\" ws \",\" ws \\\"\\\"file\\\"\\\" ws \":\" ws string ws \",\" ws \\\"\\\"content\\\"\\\" ws \":\" ws string ws \"}\"",
+    "delete ::= \"{\" ws \\\"\\\"action\\\"\\\" ws \":\" ws \\\"\\\"delete\\\"\\\" ws \",\" ws \\\"\\\"file\\\"\\\" ws \":\" ws string ws \"}\"",
+    "string ::= \"\\\"\" chars \"\\\"\"",
+    "chars ::= (char)*",
+    "char ::= [^\"\\\\] | \"\\\\\" [\"\\\\/bfnrt] | \"\\\\\" \"u\" hex hex hex hex",
+    "hex ::= [0-9a-fA-F]",
+    "ws ::= [ \\t\\n\\r]*",
+].join("\n");
+export const BUILDER_PATCH_GBNF_FILE_WRITES = [
+    "root ::= ws object ws",
+    "object ::= \"{\" ws \\\"\\\"files\\\"\\\" ws \":\" ws file_array ws (ws \",\" ws \\\"\\\"delete\\\"\\\" ws \":\" ws string_array ws)? \"}\"",
+    "file_array ::= \"[\" ws file_entry (ws \",\" ws file_entry)* ws \"]\"",
+    "file_entry ::= \"{\" ws \\\"\\\"path\\\"\\\" ws \":\" ws string ws \",\" ws \\\"\\\"content\\\"\\\" ws \":\" ws string ws \"}\"",
+    "string_array ::= \"[\" ws (string (ws \",\" ws string)*)? ws \"]\"",
+    "string ::= \"\\\"\" chars \"\\\"\"",
+    "chars ::= (char)*",
+    "char ::= [^\"\\\\] | \"\\\\\" [\"\\\\/bfnrt] | \"\\\\\" \"u\" hex hex hex hex",
+    "hex ::= [0-9a-fA-F]",
+    "ws ::= [ \\t\\n\\r]*",
+].join("\n");
+const BUILDER_PROMPT_TOOL_CALLS = [
+    "ROLE: Builder",
+    "TASK: Implement the plan using tools.",
+    "CONTEXT NOTES:",
+    "- Respect constraints found in the USER PROFILE and REPO MEMORY.",
+    "- Focus files contain full content; periphery files contain interfaces/summaries only.",
+    "- Avoid modifying periphery unless the plan explicitly requires it.",
+    "- Follow the WRITE POLICY section in the context bundle. Do not edit read-only paths.",
+    "- Do not alter requirements/specs to bypass the task; implement the requested change.",
+    "CONSTRAINTS:",
+    "- Use tools for file changes.",
+    "- You can use 'docdex_delegate' to offload simple tasks (docstrings, small tests) to a cheaper model.",
+    "- Follow the plan and do not invent files.",
+    '- If missing required context, respond with JSON: {"needs_context": true, "queries": ["..."], "files": ["..."], "reason": "..."}',
+    "- Respond with a concise summary when done.",
+].join("\n");
+const BUILDER_PROMPT_FREEFORM = [
+    "ROLE: Builder",
+    "TASK: Implement the plan with freeform output (no strict schema).",
+    "CONTEXT NOTES:",
+    "- Respect constraints found in the USER PROFILE and REPO MEMORY.",
+    "- Focus files contain full content; periphery files contain interfaces/summaries only.",
+    "- Avoid modifying periphery unless the plan explicitly requires it.",
+    "- Follow the WRITE POLICY section in the context bundle. Do not edit read-only paths.",
+    "- Do not alter requirements/specs to bypass the task; implement the requested change.",
+    "CONSTRAINTS:",
+    "- Do NOT call tools.",
+    "- Do NOT output JSON or YAML.",
+    "- Provide a concise change summary and exact code snippets.",
+    "- If you propose a file change, include an explicit file path and either a full file or an exact snippet.",
+    "- Do not include markdown fences around code blocks.",
+    "- If missing required context, explain what is missing in plain text.",
+].join("\n");
+const BUILDER_PROMPT_PATCH_JSON_SEARCH_REPLACE = [
+    "ROLE: Builder",
+    "TASK: Implement the plan by emitting a JSON patch payload.",
+    "CONTEXT NOTES:",
+    "- Respect constraints found in the USER PROFILE and REPO MEMORY.",
+    "- Focus files contain full content; periphery files contain interfaces/summaries only.",
+    "- Avoid modifying periphery unless the plan explicitly requires it.",
+    "- Follow the WRITE POLICY section in the context bundle. Do not edit read-only paths.",
+    "- Do not alter requirements/specs to bypass the task; implement the requested change.",
+    "CONSTRAINTS:",
+    "- Do NOT call tools.",
+    "- Respond with JSON only (no prose, no markdown, no code fences).",
+    "- Output must be a single JSON object and must start with '{' and end with '}'.",
+    "- Do not include top-level keys other than \"patches\".",
+    "- Do not include commentary, summaries, plan echoes, or extra metadata.",
+    "- Prefer files from the provided context bundle, but you may edit other workspace files if needed and allowed by the WRITE POLICY.",
+    "- The plan and context bundle are input-only; do NOT echo or restate them.",
+    "- Never use literal placeholder values like \"...\", \"path/to/file\", \"path/to/new\", or \"path/to/old\".",
+    "- Never return an empty patches array.",
+    '- If missing required context, respond with JSON: {"needs_context": true, "queries": ["..."], "files": ["..."], "reason": "..."}',
+    "PATCH SCHEMA:",
+    '- Top-level object with key "patches": array.',
+    '- Replace entry keys: "action": "replace", "file", "search_block", "replace_block".',
+    '- Create entry keys: "action": "create", "file", "content".',
+    '- Delete entry keys: "action": "delete", "file".',
+    '- Every string value must be concrete and non-empty.',
+].join("\n");
+const BUILDER_PROMPT_PATCH_JSON_FILE_WRITES = [
+    "ROLE: Builder",
+    "TASK: Implement the plan by emitting a JSON file-write payload.",
+    "CONTEXT NOTES:",
+    "- Respect constraints found in the USER PROFILE and REPO MEMORY.",
+    "- Focus files contain full content; periphery files contain interfaces/summaries only.",
+    "- Avoid modifying periphery unless the plan explicitly requires it.",
+    "- Follow the WRITE POLICY section in the context bundle. Do not edit read-only paths.",
+    "- Do not alter requirements/specs to bypass the task; implement the requested change.",
+    "CONSTRAINTS:",
+    "- Do NOT call tools.",
+    "- Respond with JSON only (no prose, no markdown, no code fences).",
+    "- Output must be a single JSON object and must start with '{' and end with '}'.",
+    "- Do not include top-level keys other than \"files\" and optional \"delete\".",
+    "- Do not include commentary, summaries, plan echoes, or extra metadata.",
+    "- Prefer files from the provided context bundle, but you may edit other workspace files if needed and allowed by the WRITE POLICY.",
+    "- The plan and context bundle are input-only; do NOT echo or restate them.",
+    "- Never use literal placeholder values like \"...\", \"path/to/file\", \"path/to/new\", or \"path/to/old\".",
+    "- Never return an empty files array.",
+    '- If missing required context, respond with JSON: {"needs_context": true, "queries": ["..."], "files": ["..."], "reason": "..."}',
+    "- Output MUST start with a JSON object that includes a top-level \"files\" array.",
+    "- Do not include any extra keys beyond \"files\" and optional \"delete\".",
+    "PATCH SCHEMA:",
+    '- Top-level object with key "files": array.',
+    '- File entry keys: "path": <string>, "content": <string> (both required, non-empty).',
+    '- Optional "delete": string array for files to remove.',
+].join("\n");
+export const buildBuilderPrompt = (mode, patchFormat = "search_replace") => {
+    if (mode === "freeform") {
+        return BUILDER_PROMPT_FREEFORM;
+    }
+    if (mode !== "patch_json") {
+        return BUILDER_PROMPT_TOOL_CALLS;
+    }
+    return patchFormat === "file_writes"
+        ? BUILDER_PROMPT_PATCH_JSON_FILE_WRITES
+        : BUILDER_PROMPT_PATCH_JSON_SEARCH_REPLACE;
+};
+const INTERPRETER_PROMPT_BASE = [
+    "ROLE: Patch Interpreter",
+    "TASK: Convert the builder output into a JSON patch payload.",
+    "CONSTRAINTS:",
+    "- Output JSON only (no prose, no markdown, no code fences).",
+    "- Do not invent files outside the builder output.",
+    "- Do not include explanations.",
+    "- Never use literal placeholder values like \"...\" or \"path/to/file\".",
+].join("\n");
+const INTERPRETER_PROMPT_SEARCH_REPLACE = [
+    INTERPRETER_PROMPT_BASE,
+    "PATCH SCHEMA:",
+    '- Top-level object with key "patches": array.',
+    '- Replace entry keys: "action": "replace", "file", "search_block", "replace_block".',
+    '- Create entry keys: "action": "create", "file", "content".',
+    '- Delete entry keys: "action": "delete", "file".',
+    '- Every string value must be concrete and non-empty.',
+].join("\n");
+const INTERPRETER_PROMPT_FILE_WRITES = [
+    INTERPRETER_PROMPT_BASE,
+    "PATCH SCHEMA:",
+    '- Top-level object with key "files": array.',
+    '- File entry keys: "path": <string>, "content": <string> (both required, non-empty).',
+    '- Optional "delete": string array for files to remove.',
+].join("\n");
+const INTERPRETER_RETRY_PROMPT_BASE = [
+    "ROLE: Patch Interpreter",
+    "TASK: Respond ONLY with valid JSON matching the patch schema.",
+    "CONSTRAINTS:",
+    "- Output JSON only (no prose, no markdown, no code fences).",
+    "- The response must start with '{' or '['.",
+    "- Never use literal placeholder values like \"...\" or \"path/to/file\".",
+].join("\n");
+const INTERPRETER_RETRY_SEARCH_REPLACE = [
+    INTERPRETER_RETRY_PROMPT_BASE,
+    "PATCH SCHEMA:",
+    '- Top-level object with key "patches": array.',
+    '- Replace entry keys: "action": "replace", "file", "search_block", "replace_block".',
+    '- Create entry keys: "action": "create", "file", "content".',
+    '- Delete entry keys: "action": "delete", "file".',
+    '- Every string value must be concrete and non-empty.',
+].join("\n");
+const INTERPRETER_RETRY_FILE_WRITES = [
+    INTERPRETER_RETRY_PROMPT_BASE,
+    "PATCH SCHEMA:",
+    '- Top-level object with key "files": array.',
+    '- File entry keys: "path": <string>, "content": <string> (both required, non-empty).',
+    '- Optional "delete": string array for files to remove.',
+].join("\n");
+export const buildInterpreterPrompt = (patchFormat = "search_replace") => patchFormat === "file_writes"
+    ? INTERPRETER_PROMPT_FILE_WRITES
+    : INTERPRETER_PROMPT_SEARCH_REPLACE;
+export const buildInterpreterRetryPrompt = (patchFormat = "search_replace") => patchFormat === "file_writes"
+    ? INTERPRETER_RETRY_FILE_WRITES
+    : INTERPRETER_RETRY_SEARCH_REPLACE;
+export const BUILDER_PROMPT = BUILDER_PROMPT_TOOL_CALLS;
+export const CRITIC_PROMPT = [
+    "ROLE: Critic",
+    "TASK: Validate the implementation against the plan and checks.",
+    "CONSTRAINTS:",
+    "- Do NOT generate code.",
+    "- Report pass/fail with reasons.",
+].join("\n");
+export const CONTEXT_SUMMARY_PROMPT = [
+    "ROLE: Context Summarizer",
+    "TASK: Summarize the key technical decisions, constraints, and open questions from this conversation.",
+    "OUTPUT: Keep it concise and action-oriented.",
+].join("\n");

package/dist/vendor/codali/cognitive/ProviderRouting.d.ts

@@ -0,0 +1,16 @@
+import type { ProviderConfig, ProviderResponseFormat } from "../providers/ProviderTypes.js";
+import type { RoutingConfig, RoutingPhaseConfig } from "../config/Config.js";
+export type PipelinePhase = "librarian" | "architect" | "builder" | "critic" | "interpreter";
+export interface ProviderDefaults {
+    provider: string;
+    config: ProviderConfig;
+}
+export interface RoutedProvider {
+    provider: string;
+    config: ProviderConfig;
+    temperature?: number;
+    responseFormat?: ProviderResponseFormat;
+}
+export declare const resolvePhaseRouting: (routing: RoutingConfig | undefined, phase: PipelinePhase) => RoutingPhaseConfig | undefined;
+export declare const buildRoutedProvider: (phase: PipelinePhase, defaults: ProviderDefaults, routing?: RoutingConfig, lockProviderModel?: boolean) => RoutedProvider;
+//# sourceMappingURL=ProviderRouting.d.ts.map

package/dist/vendor/codali/cognitive/ProviderRouting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderRouting.d.ts","sourceRoot":"","sources":["../../src/cognitive/ProviderRouting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE7E,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE7F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,sBAAsB,CAAC;CACzC;AAgBD,eAAO,MAAM,mBAAmB,GAC9B,SAAS,aAAa,GAAG,SAAS,EAClC,OAAO,aAAa,KACnB,kBAAkB,GAAG,SAA6B,CAAC;AAEtD,eAAO,MAAM,mBAAmB,GAC9B,OAAO,aAAa,EACpB,UAAU,gBAAgB,EAC1B,UAAU,aAAa,EACvB,2BAAyB,KACxB,cAWF,CAAC"}

package/dist/vendor/codali/cognitive/ProviderRouting.js

@@ -0,0 +1,24 @@
+const toResponseFormat = (format, grammar) => {
+    if (!format)
+        return undefined;
+    if (format === "json") {
+        return { type: "json" };
+    }
+    if ((format === "gbnf" || format === "grammar") && grammar) {
+        return { type: "gbnf", grammar };
+    }
+    return undefined;
+};
+export const resolvePhaseRouting = (routing, phase) => routing?.[phase];
+export const buildRoutedProvider = (phase, defaults, routing, lockProviderModel = false) => {
+    const phaseConfig = resolvePhaseRouting(routing, phase);
+    return {
+        provider: lockProviderModel ? defaults.provider : phaseConfig?.provider ?? defaults.provider,
+        config: {
+            ...defaults.config,
+            model: lockProviderModel ? defaults.config.model : phaseConfig?.model ?? defaults.config.model,
+        },
+        temperature: phaseConfig?.temperature,
+        responseFormat: toResponseFormat(phaseConfig?.format, phaseConfig?.grammar),
+    };
+};

package/dist/vendor/codali/cognitive/QueryExtraction.d.ts

@@ -0,0 +1,12 @@
+import type { Provider } from "../providers/ProviderTypes.js";
+import type { RunLogger } from "../runtime/RunLogger.js";
+export interface QuerySignals {
+    phrases: string[];
+    file_tokens: string[];
+    keywords: string[];
+    keyword_phrases: string[];
+}
+export declare const extractQuerySignals: (input: string) => QuerySignals;
+export declare const extractQueries: (input: string, maxQueries?: number) => string[];
+export declare const expandQueriesWithProvider: (provider: Provider, request: string, baseQueries: string[], maxQueries?: number, temperature?: number, fileHints?: string[], logger?: RunLogger) => Promise<string[]>;
+//# sourceMappingURL=QueryExtraction.d.ts.map

package/dist/vendor/codali/cognitive/QueryExtraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryExtraction.d.ts","sourceRoot":"","sources":["../../src/cognitive/QueryExtraction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,+BAA+B,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAsGzD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AA4DD,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,KAAG,YAqBnD,CAAC;AAgBF,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,mBAAc,KAAG,MAAM,EAiBpE,CAAC;AAoCF,eAAO,MAAM,yBAAyB,GACpC,UAAU,QAAQ,EAClB,SAAS,MAAM,EACf,aAAa,MAAM,EAAE,EACrB,mBAAc,EACd,cAAc,MAAM,EACpB,YAAY,MAAM,EAAE,EACpB,SAAS,SAAS,KACjB,OAAO,CAAC,MAAM,EAAE,CA4BlB,CAAC"}

package/dist/vendor/codali/cognitive/QueryExtraction.js

@@ -0,0 +1,262 @@
+const STOPWORDS = new Set([
+    "the",
+    "and",
+    "or",
+    "a",
+    "an",
+    "to",
+    "for",
+    "of",
+    "in",
+    "on",
+    "with",
+    "by",
+    "from",
+    "is",
+    "are",
+    "be",
+    "this",
+    "that",
+    "these",
+    "those",
+    "it",
+    "its",
+    "add",
+    "adds",
+    "added",
+    "adding",
+    "change",
+    "changes",
+    "changed",
+    "changing",
+    "update",
+    "updates",
+    "updated",
+    "updating",
+    "modify",
+    "modifies",
+    "modified",
+    "modifying",
+    "make",
+    "makes",
+    "making",
+    "create",
+    "creates",
+    "created",
+    "creating",
+    "only",
+    "just",
+    "please",
+    "visible",
+    "show",
+    "shows",
+    "showing",
+    "display",
+    "displayed",
+    "touch",
+    "edit",
+    "edits",
+    "editing",
+    "fix",
+    "fixes",
+    "fixed",
+    "fixing",
+    "ensure",
+    "set",
+    "sets",
+    "setting",
+    "new",
+    "develop",
+    "develops",
+    "developed",
+    "developing",
+    "engineer",
+    "engineering",
+    "implement",
+    "implements",
+    "implemented",
+    "implementing",
+    "build",
+    "builds",
+    "building",
+    "built",
+]);
+const FILE_EXTENSIONS = [
+    ".ts",
+    ".tsx",
+    ".js",
+    ".jsx",
+    ".json",
+    ".md",
+    ".yml",
+    ".yaml",
+    ".rs",
+    ".py",
+    ".go",
+    ".java",
+    ".cs",
+];
+const unique = (values) => {
+    const seen = new Set();
+    const result = [];
+    for (const value of values) {
+        const normalized = value.trim();
+        if (!normalized || seen.has(normalized))
+            continue;
+        seen.add(normalized);
+        result.push(normalized);
+    }
+    return result;
+};
+const QUERY_EXPANDER_PROMPT = [
+    "You generate concise search queries for code and docs lookup.",
+    "Return JSON only. Allowed formats:",
+    '1) {"queries":["q1","q2"]}',
+    '2) ["q1","q2"]',
+    "Max 3 queries, short phrases, no commentary.",
+].join("\n");
+const extractQuotedPhrases = (input) => {
+    const phrases = [];
+    const regexes = [/`([^`]+)`/g, /"([^"]+)"/g, /'([^']+)'/g];
+    for (const regex of regexes) {
+        let match;
+        while ((match = regex.exec(input)) !== null) {
+            const phrase = match[1]?.trim();
+            if (phrase)
+                phrases.push(phrase);
+        }
+    }
+    return phrases;
+};
+const extractFileTokens = (input) => {
+    const tokens = input.split(/\s+/).map((token) => token.replace(/[(),.;:]+$/g, ""));
+    return tokens.filter((token) => FILE_EXTENSIONS.some((ext) => token.includes(ext)));
+};
+const extractKeywords = (input) => {
+    return input
+        .split(/\s+/)
+        .map((token) => token.toLowerCase().replace(/[^a-z0-9/_-]/g, ""))
+        .filter((token) => token.length >= 3 && !STOPWORDS.has(token));
+};
+const extractKeywordPhrases = (keywords, maxPhrases = 6) => {
+    if (keywords.length < 2)
+        return [];
+    const phrases = [];
+    for (let index = 0; index < keywords.length; index += 1) {
+        const two = keywords.slice(index, index + 2);
+        const three = keywords.slice(index, index + 3);
+        if (two.length === 2)
+            phrases.push(two.join(" "));
+        if (three.length === 3)
+            phrases.push(three.join(" "));
+        if (phrases.length >= maxPhrases * 2)
+            break;
+    }
+    return unique(phrases).slice(0, Math.max(0, maxPhrases));
+};
+export const extractQuerySignals = (input) => {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        return { phrases: [], file_tokens: [], keywords: [], keyword_phrases: [] };
+    }
+    const phrases = unique([
+        ...extractQuotedPhrases(trimmed),
+        ...trimmed
+            .split(/[.!?;:]+/g)
+            .map((entry) => entry.trim())
+            .filter((entry) => entry.length >= 8),
+    ]);
+    const fileTokens = unique(extractFileTokens(trimmed));
+    const keywords = unique(extractKeywords(trimmed));
+    const keywordPhrases = extractKeywordPhrases(keywords);
+    return {
+        phrases,
+        file_tokens: fileTokens,
+        keywords,
+        keyword_phrases: keywordPhrases,
+    };
+};
+const buildKeywordFallbackQueries = (request, keywords, maxQueries) => {
+    const keyTerms = unique(keywords.filter((token) => token.length >= 4));
+    const longPhrase = keyTerms.slice(0, 4).join(" ");
+    const corePhrase = keyTerms.slice(0, 2).join(" ");
+    const fallback = unique([
+        request,
+        longPhrase,
+        corePhrase,
+        ...keyTerms,
+        ...keywords,
+    ]);
+    return fallback.slice(0, Math.max(1, maxQueries));
+};
+export const extractQueries = (input, maxQueries = 3) => {
+    const trimmed = input.trim();
+    if (!trimmed)
+        return [];
+    const signals = extractQuerySignals(trimmed);
+    const phrases = signals.phrases;
+    const fileTokens = signals.file_tokens;
+    const keywords = signals.keywords;
+    const hasAnchors = phrases.length > 0 || fileTokens.length > 0;
+    if (!hasAnchors) {
+        return buildKeywordFallbackQueries(trimmed, keywords, maxQueries);
+    }
+    const combined = unique([trimmed, ...phrases, ...fileTokens, ...signals.keyword_phrases, ...keywords]);
+    const limited = combined.slice(0, Math.max(1, maxQueries));
+    return limited;
+};
+const parseExpandedQueries = (payload) => {
+    if (!payload)
+        return [];
+    if (Array.isArray(payload)) {
+        return payload.map((entry) => String(entry)).filter(Boolean);
+    }
+    if (typeof payload === "object") {
+        const record = payload;
+        const queries = record.queries;
+        if (Array.isArray(queries)) {
+            return queries.map((entry) => String(entry)).filter(Boolean);
+        }
+    }
+    return [];
+};
+const buildQueryMessage = (request, baseQueries, maxQueries, fileHints) => ({
+    role: "user",
+    content: JSON.stringify({
+        request,
+        base_queries: baseQueries,
+        max_queries: maxQueries,
+        file_hints: fileHints ?? [],
+    }, null, 2),
+});
+export const expandQueriesWithProvider = async (provider, request, baseQueries, maxQueries = 3, temperature, fileHints, logger) => {
+    const messages = [
+        { role: "system", content: QUERY_EXPANDER_PROMPT },
+        buildQueryMessage(request, baseQueries, maxQueries, fileHints),
+    ];
+    if (logger) {
+        await logger.log("provider_request", {
+            provider: provider.name,
+            messages,
+            responseFormat: { type: "json" },
+            temperature,
+        });
+    }
+    const response = await provider.generate({
+        messages,
+        responseFormat: { type: "json" },
+        temperature,
+    });
+    const content = response.message.content?.trim() ?? "";
+    if (!content)
+        return baseQueries;
+    try {
+        const parsed = JSON.parse(content);
+        const expanded = parseExpandedQueries(parsed);
+        const merged = unique([...baseQueries, ...expanded]);
+        return merged.slice(0, Math.max(1, maxQueries));
+    }
+    catch {
+        return baseQueries;
+    }
+};

package/dist/vendor/codali/cognitive/RunHistoryIndexer.d.ts

@@ -0,0 +1,13 @@
+import type { DocdexClient } from "../docdex/DocdexClient.js";
+export interface RunHistoryHit {
+    intent: string;
+    plan: string;
+    diff: string;
+    score: number;
+}
+export declare class RunHistoryIndexer {
+    private client;
+    constructor(client: DocdexClient);
+    findSimilarRuns(intent: string, limit?: number): Promise<RunHistoryHit[]>;
+}
+//# sourceMappingURL=RunHistoryIndexer.d.ts.map