agcel 1.0.4 → 2.0.0

package/dist/cli/commands/suggest.js

@@ -0,0 +1,32 @@
+import { Command } from 'commander';
+import { Registry } from '../../core/registry.js';
+import { IntentEngine } from '../../core/intent.js';
+export const suggestCommand = new Command('suggest')
+    .description('Rank registry agents for a task and print next steps when confidence is low')
+    .argument('<query...>', 'Natural-language task description')
+    .action(async (parts) => {
+    const query = parts.join(' ').trim();
+    if (!query) {
+        console.error('Provide a non-empty query.');
+        process.exitCode = 1;
+        return;
+    }
+    const registry = new Registry();
+    const agents = await registry.loadAgents();
+    const engine = new IntentEngine();
+    const result = engine.detectIntent(query, agents, {
+        latestUserTurn: query
+    });
+    console.log(`Query: ${query}`);
+    console.log(`Confidence: ${(result.confidence * 100).toFixed(0)}%`);
+    if (result.bestAgent) {
+        console.log(`Suggested agent: ${result.bestAgent.name}`);
+    }
+    else {
+        console.log('Suggested agent: (none above threshold)');
+    }
+    if (result.suggestion) {
+        console.log(`\n${result.suggestion}`);
+    }
+});
+//# sourceMappingURL=suggest.js.map

package/dist/cli/commands/suggest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.js","sourceRoot":"","sources":["../../../src/cli/commands/suggest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;KACjD,WAAW,CACV,6EAA6E,CAC9E;KACA,QAAQ,CAAC,YAAY,EAAE,mCAAmC,CAAC;KAC3D,MAAM,CAAC,KAAK,EAAE,KAAe,EAAE,EAAE;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE;QAChD,cAAc,EAAE,KAAK;KACtB,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACpE,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACxC,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { initCommand } from './commands/init.js';
+import { installCommand } from './commands/install.js';
+import { createAgentCommand, createSkillCommand } from './commands/create.js';
+import { pulseCommand } from './commands/pulse.js';
+import { suggestCommand } from './commands/suggest.js';
+const program = new Command();
+program
+    .name('agcel')
+    .description('Agentic Context Engineering Library - CLI Tool')
+    .version('1.0.0');
+program.addCommand(initCommand);
+program.addCommand(installCommand);
+program.addCommand(createAgentCommand);
+program.addCommand(createSkillCommand);
+program.addCommand(suggestCommand);
+program.addCommand(pulseCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,gDAAgD,CAAC;KAC7D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;AACvC,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;AACvC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AAEjC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/cli/research-hints.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Curated pointers for interactive agent/skill creation (offline-friendly).
+ */
+export declare function formatResearchForSkills(skillNames: string[]): string;
+//# sourceMappingURL=research-hints.d.ts.map

package/dist/cli/research-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-hints.d.ts","sourceRoot":"","sources":["../../src/cli/research-hints.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4FH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAepE"}

package/dist/cli/research-hints.js

@@ -0,0 +1,109 @@
+/**
+ * Curated pointers for interactive agent/skill creation (offline-friendly).
+ */
+const DEFAULT_RESEARCH_URLS = [
+    'https://martinfowler.com/bliki/TwoHardThings.html',
+    'https://en.wikipedia.org/wiki/Single_responsibility_principle'
+];
+const SKILL_RESEARCH = {
+    python: [
+        'https://peps.python.org/pep-0008/',
+        'https://docs.python.org/3/library/typing.html',
+        'https://docs.pytest.org/en/stable/',
+        'https://packaging.python.org/en/latest/tutorials/packaging-projects/'
+    ],
+    java: [
+        'https://docs.oracle.com/en/java/javase/21/docs/api/index.html',
+        'https://junit.org/junit5/docs/current/user-guide/'
+    ],
+    'nodejs-typescript': [
+        'https://nodejs.org/en/docs/guides/',
+        'https://www.typescriptlang.org/docs/',
+        'https://vitest.dev/guide/'
+    ],
+    testing: [
+        'https://docs.pytest.org/en/stable/',
+        'https://vitest.dev/guide/'
+    ],
+    debugging: [
+        'https://developer.mozilla.org/en-US/docs/Tools/Debugger',
+        'https://12factor.net/logs'
+    ],
+    'react-skill': [
+        'https://react.dev/',
+        'https://www.typescriptlang.org/docs/',
+        'https://react.dev/learn/typescript'
+    ],
+    flutter: [
+        'https://docs.flutter.dev/',
+        'https://dart.dev/language',
+        'https://docs.flutter.dev/testing/overview'
+    ],
+    'product-discovery': [
+        'https://www.svpg.com/empowered-product-teams/',
+        'https://www.interaction-design.org/literature/topics/user-research'
+    ],
+    'requirements-clarity': [
+        'https://www.agilealliance.org/glossary/invest/',
+        'https://www.mountaingoatsoftware.com/agile/user-stories'
+    ],
+    'backlog-roadmap': [
+        'https://www.scrum.org/resources/blog/product-backlog-ordering-techniques',
+        'https://www.productplan.com/learn/what-is-a-product-roadmap/'
+    ],
+    'ux-product-design': [
+        'https://www.nngroup.com/articles/ten-usability-heuristics/',
+        'https://www.interaction-design.org/literature/topics/ux-design'
+    ],
+    'design-systems': [
+        'https://designsystemsrepo.com/design-systems-releases',
+        'https://www.w3.org/WAI/ARIA/apg/'
+    ],
+    'accessibility-design': [
+        'https://www.w3.org/WAI/WCAG22/quickref/',
+        'https://webaim.org/resources/designers/'
+    ],
+    'web-ui-patterns': [
+        'https://developer.mozilla.org/en-US/docs/Learn/CSS/CSS_layout/Responsive_Design',
+        'https://web.dev/articles/responsive-web-design-basics'
+    ],
+    'mobile-platform-design': [
+        'https://developer.apple.com/design/human-interface-guidelines/',
+        'https://m3.material.io/'
+    ],
+    'api-security': [
+        'https://owasp.org/API-Security/editions/2023/en/0x00-header/',
+        'https://cheatsheetseries.owasp.org/cheatsheets/REST_Security_Cheat_Sheet.html'
+    ],
+    observability: [
+        'https://opentelemetry.io/docs/',
+        'https://sre.google/sre-book/monitoring-distributed-systems/'
+    ],
+    'technical-writing': [
+        'https://developers.google.com/tech-writing',
+        'https://www.writethedocs.org/guide/'
+    ],
+    'system-architecture': [
+        'https://c4model.com/',
+        'https://adr.github.io/',
+        'https://12factor.net/'
+    ]
+};
+export function formatResearchForSkills(skillNames) {
+    const lines = [
+        'Best-practice references (open in a browser while you refine the skill):'
+    ];
+    const seen = new Set();
+    for (const raw of skillNames) {
+        const key = raw.trim().toLowerCase();
+        const urls = SKILL_RESEARCH[key] ?? DEFAULT_RESEARCH_URLS;
+        for (const u of urls) {
+            if (seen.has(u))
+                continue;
+            seen.add(u);
+            lines.push(`  - ${u}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=research-hints.js.map

package/dist/cli/research-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-hints.js","sourceRoot":"","sources":["../../src/cli/research-hints.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,qBAAqB,GAAG;IAC5B,mDAAmD;IACnD,+DAA+D;CAChE,CAAC;AAEF,MAAM,cAAc,GAA6B;IAC/C,MAAM,EAAE;QACN,mCAAmC;QACnC,+CAA+C;QAC/C,oCAAoC;QACpC,sEAAsE;KACvE;IACD,IAAI,EAAE;QACJ,+DAA+D;QAC/D,mDAAmD;KACpD;IACD,mBAAmB,EAAE;QACnB,oCAAoC;QACpC,sCAAsC;QACtC,2BAA2B;KAC5B;IACD,OAAO,EAAE;QACP,oCAAoC;QACpC,2BAA2B;KAC5B;IACD,SAAS,EAAE;QACT,yDAAyD;QACzD,2BAA2B;KAC5B;IACD,aAAa,EAAE;QACb,oBAAoB;QACpB,sCAAsC;QACtC,oCAAoC;KACrC;IACD,OAAO,EAAE;QACP,2BAA2B;QAC3B,2BAA2B;QAC3B,2CAA2C;KAC5C;IACD,mBAAmB,EAAE;QACnB,+CAA+C;QAC/C,oEAAoE;KACrE;IACD,sBAAsB,EAAE;QACtB,gDAAgD;QAChD,yDAAyD;KAC1D;IACD,iBAAiB,EAAE;QACjB,0EAA0E;QAC1E,8DAA8D;KAC/D;IACD,mBAAmB,EAAE;QACnB,4DAA4D;QAC5D,gEAAgE;KACjE;IACD,gBAAgB,EAAE;QAChB,uDAAuD;QACvD,kCAAkC;KACnC;IACD,sBAAsB,EAAE;QACtB,yCAAyC;QACzC,yCAAyC;KAC1C;IACD,iBAAiB,EAAE;QACjB,iFAAiF;QACjF,uDAAuD;KACxD;IACD,wBAAwB,EAAE;QACxB,gEAAgE;QAChE,yBAAyB;KAC1B;IACD,cAAc,EAAE;QACd,8DAA8D;QAC9D,+EAA+E;KAChF;IACD,aAAa,EAAE;QACb,gCAAgC;QAChC,6DAA6D;KAC9D;IACD,mBAAmB,EAAE;QACnB,4CAA4C;QAC5C,qCAAqC;KACtC;IACD,qBAAqB,EAAE;QACrB,sBAAsB;QACtB,wBAAwB;QACxB,uBAAuB;KACxB;CACF,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,UAAoB;IAC1D,MAAM,KAAK,GAAa;QACtB,0EAA0E;KAC3E,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,qBAAqB,CAAC;QAC1D,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,SAAS;YAC1B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACZ,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/cli/research-hints.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=research-hints.test.d.ts.map

package/dist/cli/research-hints.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-hints.test.d.ts","sourceRoot":"","sources":["../../src/cli/research-hints.test.ts"],"names":[],"mappings":""}

package/dist/cli/research-hints.test.js

@@ -0,0 +1,50 @@
+import { describe, expect, it } from 'vitest';
+import { formatResearchForSkills } from './research-hints.js';
+describe('formatResearchForSkills', () => {
+    it('Given python skill when formatting then PEP 8 and packaging links are included', () => {
+        const out = formatResearchForSkills(['python']);
+        expect(out).toContain('pep-0008');
+        expect(out).toContain('packaging.python.org');
+    });
+    it('Given product-discovery skill when formatting then curated PM link is included', () => {
+        const out = formatResearchForSkills(['product-discovery']);
+        expect(out).toContain('svpg.com');
+    });
+    it('Given accessibility-design skill when formatting then WCAG quick reference is included', () => {
+        const out = formatResearchForSkills(['accessibility-design']);
+        expect(out).toContain('WCAG22');
+    });
+    it('Given react-skill when formatting then React docs link is included', () => {
+        const out = formatResearchForSkills(['react-skill']);
+        expect(out).toContain('react.dev');
+    });
+    it('Given flutter skill when formatting then Flutter docs link is included', () => {
+        const out = formatResearchForSkills(['flutter']);
+        expect(out).toContain('docs.flutter.dev');
+    });
+    it('Given java skill when formatting then JUnit guide link is included', () => {
+        const out = formatResearchForSkills(['java']);
+        expect(out).toContain('junit.org');
+    });
+    it('Given nodejs-typescript skill when formatting then Node docs link is included', () => {
+        const out = formatResearchForSkills(['nodejs-typescript']);
+        expect(out).toContain('nodejs.org');
+    });
+    it('Given api-security skill when formatting then OWASP API Security link is included', () => {
+        const out = formatResearchForSkills(['api-security']);
+        expect(out).toContain('owasp.org/API-Security');
+    });
+    it('Given observability skill when formatting then OpenTelemetry docs link is included', () => {
+        const out = formatResearchForSkills(['observability']);
+        expect(out).toContain('opentelemetry.io');
+    });
+    it('Given technical-writing skill when formatting then Google tech writing link is included', () => {
+        const out = formatResearchForSkills(['technical-writing']);
+        expect(out).toContain('developers.google.com/tech-writing');
+    });
+    it('Given system-architecture skill when formatting then C4 model link is included', () => {
+        const out = formatResearchForSkills(['system-architecture']);
+        expect(out).toContain('c4model.com');
+    });
+});
+//# sourceMappingURL=research-hints.test.js.map

package/dist/cli/research-hints.test.js.map

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

package/dist/core/agcel-config.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shape of `.agcel/config.json` relevant to context and RAG.
+ */
+export type RagBackend = 'local' | 'chroma';
+export interface ChromaConnectionConfig {
+    host?: string;
+    port?: number;
+    ssl?: boolean;
+    collectionName?: string;
+}
+export interface AgcelConfig {
+    ragEnabled?: boolean;
+    /** When omitted and RAG is on, defaults to `local`. */
+    ragBackend?: RagBackend;
+    chroma?: ChromaConnectionConfig;
+    /** When set, RAG queries only return documents whose metadata matches all key/value pairs. */
+    ragQueryMetadataFilter?: Record<string, string>;
+    /**
+     * When true, `route_query` with `draft_output` sets `guardrails_blocked` if error-severity
+     * guardrails fail (host should not treat the draft as shippable).
+     */
+    strictGuardrailsOnRouteQuery?: boolean;
+}
+export declare const DEFAULT_CHROMA_HOST = "localhost";
+export declare const DEFAULT_CHROMA_PORT = 8000;
+export declare const DEFAULT_CHROMA_COLLECTION = "agcel";
+//# sourceMappingURL=agcel-config.d.ts.map

package/dist/core/agcel-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agcel-config.d.ts","sourceRoot":"","sources":["../../src/core/agcel-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5C,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,8FAA8F;IAC9F,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD;;;OAGG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAC;CACxC;AAED,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAC/C,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,yBAAyB,UAAU,CAAC"}

package/dist/core/agcel-config.js

@@ -0,0 +1,4 @@
+export const DEFAULT_CHROMA_HOST = 'localhost';
+export const DEFAULT_CHROMA_PORT = 8000;
+export const DEFAULT_CHROMA_COLLECTION = 'agcel';
+//# sourceMappingURL=agcel-config.js.map

package/dist/core/agcel-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agcel-config.js","sourceRoot":"","sources":["../../src/core/agcel-config.ts"],"names":[],"mappings":"AA0BA,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;AAC/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACxC,MAAM,CAAC,MAAM,yBAAyB,GAAG,OAAO,CAAC"}

package/dist/core/build-rag-engine.d.ts

@@ -0,0 +1,12 @@
+import type { AgcelConfig } from './agcel-config.js';
+import type { IRagEngine } from './rag-types.js';
+export type RagEngineMode = 'chroma' | 'local';
+export interface BuildRagEngineResult {
+    engine: IRagEngine;
+    mode: RagEngineMode;
+}
+/**
+ * Builds the active RAG engine from config. Chroma failures fall back to local JSON index.
+ */
+export declare function buildRagEngine(basePath: string, config: AgcelConfig): Promise<BuildRagEngineResult>;
+//# sourceMappingURL=build-rag-engine.d.ts.map

package/dist/core/build-rag-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-rag-engine.d.ts","sourceRoot":"","sources":["../../src/core/build-rag-engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAiBzG"}

package/dist/core/build-rag-engine.js

@@ -0,0 +1,24 @@
+import * as path from 'node:path';
+import { ChromaRagEngine } from './chroma-rag.js';
+import { LocalRagEngine } from './local-rag.js';
+/**
+ * Builds the active RAG engine from config. Chroma failures fall back to local JSON index.
+ */
+export async function buildRagEngine(basePath, config) {
+    const localPath = path.join(basePath, '.agcel', 'rag');
+    const localEngine = new LocalRagEngine(localPath);
+    if (config.ragBackend === 'chroma') {
+        try {
+            const chromaEngine = new ChromaRagEngine(config.chroma);
+            await chromaEngine.initialize();
+            return { engine: chromaEngine, mode: 'chroma' };
+        }
+        catch {
+            await localEngine.initialize();
+            return { engine: localEngine, mode: 'local' };
+        }
+    }
+    await localEngine.initialize();
+    return { engine: localEngine, mode: 'local' };
+}
+//# sourceMappingURL=build-rag-engine.js.map

package/dist/core/build-rag-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-rag-engine.js","sourceRoot":"","sources":["../../src/core/build-rag-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAUhD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,MAAmB;IACxE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;IAElD,IAAI,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACxD,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC;YAChC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,WAAW,CAAC,UAAU,EAAE,CAAC;YAC/B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;IAED,MAAM,WAAW,CAAC,UAAU,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAChD,CAAC"}

package/dist/core/build-rag-engine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=build-rag-engine.test.d.ts.map

package/dist/core/build-rag-engine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-rag-engine.test.d.ts","sourceRoot":"","sources":["../../src/core/build-rag-engine.test.ts"],"names":[],"mappings":""}

package/dist/core/build-rag-engine.test.js

@@ -0,0 +1,34 @@
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { buildRagEngine } from './build-rag-engine.js';
+describe('buildRagEngine', () => {
+    let tmpDir;
+    afterEach(async () => {
+        if (tmpDir) {
+            await fs.rm(tmpDir, { recursive: true, force: true });
+        }
+    });
+    it('Given chroma backend and no server on port when building then falls back to local engine', async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'agcel-build-rag-'));
+        await fs.mkdir(path.join(tmpDir, '.agcel', 'rag'), { recursive: true });
+        const { engine, mode } = await buildRagEngine(tmpDir, {
+            ragBackend: 'chroma',
+            chroma: { host: '127.0.0.1', port: 59987 }
+        });
+        expect(mode).toBe('local');
+        await engine.addDocument('doc1', 'hello world');
+        const results = await engine.query('hello', 1);
+        expect(results[0]?.content).toBe('hello world');
+    });
+    it('Given local backend when building then uses local engine', async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'agcel-build-rag-'));
+        const { engine, mode } = await buildRagEngine(tmpDir, { ragBackend: 'local' });
+        expect(mode).toBe('local');
+        await engine.addDocument('a', 'typescript modules');
+        const results = await engine.query('typescript', 1);
+        expect(results[0]?.id).toBe('a');
+    });
+});
+//# sourceMappingURL=build-rag-engine.test.js.map

package/dist/core/build-rag-engine.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-rag-engine.test.js","sourceRoot":"","sources":["../../src/core/build-rag-engine.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAI,MAAc,CAAC;IAEnB,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0FAA0F,EAAE,KAAK,IAAI,EAAE;QACxG,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;QACtE,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAExE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE;YACpD,UAAU,EAAE,QAAQ;YACpB,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE;SAC3C,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAEtE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QAE/E,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,MAAM,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/chroma-rag.d.ts

@@ -0,0 +1,20 @@
+import type { IRagEngine, RagSearchResult } from './rag-types.js';
+import { type ChromaConnectionConfig } from './agcel-config.js';
+/**
+ * ChromaDB-backed RAG over a running Chroma server (`chroma run` or Docker).
+ * Uses the official JS client and default local embeddings for documents and queries.
+ */
+export declare class ChromaRagEngine implements IRagEngine {
+    private collection;
+    private readonly client;
+    private readonly collectionName;
+    private readonly embeddingFunction;
+    constructor(chroma?: ChromaConnectionConfig);
+    initialize(): Promise<void>;
+    private requireCollection;
+    addDocument(id: string, content: string, metadata?: Record<string, string>): Promise<void>;
+    query(queryText: string, topK?: number, metadataFilter?: Record<string, string>): Promise<RagSearchResult[]>;
+    removeDocument(id: string): Promise<void>;
+    getDocumentCount(): Promise<number>;
+}
+//# sourceMappingURL=chroma-rag.d.ts.map

package/dist/core/chroma-rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chroma-rag.d.ts","sourceRoot":"","sources":["../../src/core/chroma-rag.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,mBAAmB,CAAC;AA2B3B;;;GAGG;AACH,qBAAa,eAAgB,YAAW,UAAU;IAChD,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;gBAEjD,MAAM,CAAC,EAAE,sBAAsB;IASrC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,OAAO,CAAC,iBAAiB;IAOnB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9F,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,MAAU,EAChB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,OAAO,CAAC,eAAe,EAAE,CAAC;IAuCvB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;CAG1C"}

package/dist/core/chroma-rag.js

@@ -0,0 +1,108 @@
+import { ChromaClient } from 'chromadb';
+import { DefaultEmbeddingFunction } from '@chroma-core/default-embed';
+import { DEFAULT_CHROMA_COLLECTION, DEFAULT_CHROMA_HOST, DEFAULT_CHROMA_PORT } from './agcel-config.js';
+import { recencyScoreMultiplier } from './rag-metadata.js';
+function distanceToScore(distance) {
+    if (distance == null || Number.isNaN(distance))
+        return 0;
+    return 1 / (1 + distance);
+}
+function toChromaMetadata(meta) {
+    const out = {};
+    for (const [k, v] of Object.entries(meta)) {
+        out[k] = v;
+    }
+    return out;
+}
+function chromaWhereFromFilter(filter) {
+    const entries = Object.entries(filter);
+    if (entries.length === 1) {
+        const [k, v] = entries[0];
+        return { [k]: v };
+    }
+    return {
+        $and: entries.map(([k, v]) => ({ [k]: v }))
+    };
+}
+/**
+ * ChromaDB-backed RAG over a running Chroma server (`chroma run` or Docker).
+ * Uses the official JS client and default local embeddings for documents and queries.
+ */
+export class ChromaRagEngine {
+    collection;
+    client;
+    collectionName;
+    embeddingFunction;
+    constructor(chroma) {
+        const host = chroma?.host ?? DEFAULT_CHROMA_HOST;
+        const port = chroma?.port ?? DEFAULT_CHROMA_PORT;
+        const ssl = chroma?.ssl ?? false;
+        this.collectionName = chroma?.collectionName ?? DEFAULT_CHROMA_COLLECTION;
+        this.client = new ChromaClient({ host, port, ssl });
+        this.embeddingFunction = new DefaultEmbeddingFunction();
+    }
+    async initialize() {
+        await this.client.heartbeat();
+        this.collection = await this.client.getOrCreateCollection({
+            name: this.collectionName,
+            embeddingFunction: this.embeddingFunction
+        });
+    }
+    requireCollection() {
+        if (!this.collection) {
+            throw new Error('ChromaRagEngine not initialized; call initialize() first');
+        }
+        return this.collection;
+    }
+    async addDocument(id, content, metadata = {}) {
+        const col = this.requireCollection();
+        const metadatas = Object.keys(metadata).length > 0 ? [toChromaMetadata(metadata)] : undefined;
+        await col.upsert({
+            ids: [id],
+            documents: [content],
+            ...(metadatas ? { metadatas } : {})
+        });
+    }
+    async query(queryText, topK = 5, metadataFilter) {
+        const col = this.requireCollection();
+        const hasFilter = metadataFilter && Object.keys(metadataFilter).length > 0;
+        const raw = await col.query({
+            queryTexts: [queryText],
+            nResults: topK,
+            include: ['documents', 'distances', 'metadatas'],
+            ...(hasFilter ? { where: chromaWhereFromFilter(metadataFilter) } : {})
+        });
+        const ids = raw.ids[0] ?? [];
+        const docs = raw.documents[0] ?? [];
+        const dists = raw.distances[0] ?? [];
+        const metas = raw.metadatas?.[0] ?? [];
+        const out = [];
+        for (let i = 0; i < ids.length; i++) {
+            const id = ids[i];
+            const content = docs[i];
+            if (id == null || content == null)
+                continue;
+            const metaRaw = metas[i];
+            const meta = metaRaw
+                ? Object.fromEntries(Object.entries(metaRaw).map(([k, v]) => [k, String(v)]))
+                : undefined;
+            let score = distanceToScore(dists[i] ?? null);
+            score *= recencyScoreMultiplier(meta?.updatedAt);
+            out.push({
+                id,
+                content,
+                score,
+                ...(meta ? { metadata: meta } : {})
+            });
+        }
+        return out;
+    }
+    async removeDocument(id) {
+        const col = this.requireCollection();
+        await col.delete({ ids: [id] });
+    }
+    async getDocumentCount() {
+        return this.requireCollection().count();
+    }
+}
+//# sourceMappingURL=chroma-rag.js.map

package/dist/core/chroma-rag.js.map

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

package/dist/core/context-hygiene.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Removes near-duplicate blocks from retrieved context to save tokens.
+ */
+/**
+ * Dedup RAG chunks separated by `\n\n---\n\n`.
+ */
+export declare function deduplicateRetrievalBlocks(text: string): string;
+/**
+ * Fallback dedup for MEMORY.md style text (paragraph-level).
+ */
+export declare function deduplicateLines(text: string): string;
+//# sourceMappingURL=context-hygiene.d.ts.map

package/dist/core/context-hygiene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-hygiene.d.ts","sourceRoot":"","sources":["../../src/core/context-hygiene.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAe/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWrD"}

package/dist/core/context-hygiene.js

@@ -0,0 +1,43 @@
+/**
+ * Removes near-duplicate blocks from retrieved context to save tokens.
+ */
+function normalizeForDedup(s) {
+    return s.replace(/\s+/g, ' ').trim().toLowerCase();
+}
+/**
+ * Dedup RAG chunks separated by `\n\n---\n\n`.
+ */
+export function deduplicateRetrievalBlocks(text) {
+    const sep = '\n\n---\n\n';
+    if (!text.includes(sep)) {
+        return deduplicateLines(text);
+    }
+    const blocks = text.split(sep).map((b) => b.trim()).filter(Boolean);
+    const seen = new Set();
+    const out = [];
+    for (const b of blocks) {
+        const key = normalizeForDedup(b).slice(0, 800);
+        if (key.length === 0 || seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(b);
+    }
+    return out.join(sep);
+}
+/**
+ * Fallback dedup for MEMORY.md style text (paragraph-level).
+ */
+export function deduplicateLines(text) {
+    const paras = text.split(/\n\n+/).map((p) => p.trim()).filter(Boolean);
+    const seen = new Set();
+    const out = [];
+    for (const p of paras) {
+        const key = normalizeForDedup(p).slice(0, 800);
+        if (key.length === 0 || seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(p);
+    }
+    return out.join('\n\n');
+}
+//# sourceMappingURL=context-hygiene.js.map

package/dist/core/context-hygiene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-hygiene.js","sourceRoot":"","sources":["../../src/core/context-hygiene.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,SAAS,iBAAiB,CAAC,CAAS;IAClC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,MAAM,GAAG,GAAG,aAAa,CAAC;IAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC/C,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAChD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC/C,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAChD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC"}

package/dist/core/context-hygiene.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context-hygiene.test.d.ts.map

package/dist/core/context-hygiene.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-hygiene.test.d.ts","sourceRoot":"","sources":["../../src/core/context-hygiene.test.ts"],"names":[],"mappings":""}