@amodalai/runtime 0.3.49 → 0.3.51

package/dist/src/intent/loader.js

@@ -0,0 +1,112 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Load intents from `<repoPath>/intents/<id>/intent.ts`. Each subdir is
+ * one intent; its `intent.ts` default-exports an `IntentDefinition`.
+ *
+ * Compiles each entry with esbuild (same approach as `tool-executor-local`
+ * uses for tool handlers) so authors can split helpers across sibling
+ * `.ts` files inside the intent's directory. Output goes into a
+ * sibling `.build/` directory so the source tree stays clean.
+ *
+ * Skipped silently when:
+ *   - `<repoPath>/intents/` doesn't exist (most agents don't have intents)
+ *   - A subdir has no `intent.ts` (probably a future siblings dir)
+ *
+ * Throws when:
+ *   - `intent.ts` exists but the default export isn't a valid
+ *     IntentDefinition shape (caller surface, fail fast)
+ */
+import { existsSync, mkdirSync } from 'node:fs';
+import { readdir, stat } from 'node:fs/promises';
+import * as path from 'node:path';
+import { pathToFileURL } from 'node:url';
+/**
+ * Read the intents directory and return a sorted list of loaded
+ * IntentDefinitions. Empty array when the directory is missing.
+ *
+ * Sort order is alphabetical by directory name. `matchIntent` walks
+ * the list in registration order, so the directory name controls
+ * which regex is tested first when two intents could match the same
+ * input. Author intent ids accordingly (the id IS the directory name).
+ */
+export async function loadIntents(repoPath) {
+    const intentsDir = path.join(repoPath, 'intents');
+    if (!existsSync(intentsDir))
+        return [];
+    let dirEntries;
+    try {
+        dirEntries = await readdir(intentsDir);
+    }
+    catch {
+        return [];
+    }
+    dirEntries.sort();
+    const loaded = [];
+    for (const name of dirEntries) {
+        if (name.startsWith('.') || name.startsWith('_'))
+            continue;
+        const subdirPath = path.join(intentsDir, name);
+        let stats;
+        try {
+            stats = await stat(subdirPath);
+        }
+        catch {
+            continue;
+        }
+        if (!stats.isDirectory())
+            continue;
+        const intentFile = path.join(subdirPath, 'intent.ts');
+        if (!existsSync(intentFile))
+            continue;
+        const def = await loadIntentModule(name, intentFile);
+        loaded.push(def);
+    }
+    return loaded;
+}
+/**
+ * Compile + import a single intent.ts. esbuild runs with
+ * `bundle: true, packages: 'external'` so sibling .ts helpers get
+ * inlined while npm + node:* imports stay external for normal
+ * Node resolution.
+ */
+async function loadIntentModule(dirName, intentFilePath) {
+    const buildDir = path.join(path.dirname(intentFilePath), '.build');
+    const outFile = path.join(buildDir, 'intent.mjs');
+    mkdirSync(buildDir, { recursive: true });
+    const { build } = await import('esbuild');
+    await build({
+        entryPoints: [intentFilePath],
+        outfile: outFile,
+        bundle: true,
+        packages: 'external',
+        format: 'esm',
+        platform: 'node',
+        target: 'node20',
+        logLevel: 'warning',
+    });
+    const moduleUrl = pathToFileURL(outFile).href;
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- dynamic import boundary; validated below
+    const mod = (await import(moduleUrl));
+    const def = mod.default;
+    if (!isValidIntentDefinition(def)) {
+        throw new Error(`Intent "${dirName}" at ${intentFilePath} must default-export an IntentDefinition with {id: string, regex: RegExp, handle: function}.`);
+    }
+    if (def.id !== dirName) {
+        throw new Error(`Intent at ${intentFilePath} has id "${def.id}" but lives in directory "${dirName}". The id must match the directory name.`);
+    }
+    return def;
+}
+function isValidIntentDefinition(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- discriminating shape check
+    const v = value;
+    return (typeof v['id'] === 'string' &&
+        v['regex'] instanceof RegExp &&
+        typeof v['handle'] === 'function');
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/intent/loader.js.map

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

package/dist/src/intent/loader.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};

package/dist/src/intent/loader.test.js

@@ -0,0 +1,86 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtemp, mkdir, writeFile, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import * as path from 'node:path';
+import { loadIntents } from './loader.js';
+describe('loadIntents', () => {
+    let repoPath;
+    beforeEach(async () => {
+        repoPath = await mkdtemp(path.join(tmpdir(), 'intent-loader-test-'));
+    });
+    afterEach(async () => {
+        await rm(repoPath, { recursive: true, force: true });
+    });
+    it('returns empty array when intents/ does not exist', async () => {
+        const intents = await loadIntents(repoPath);
+        expect(intents).toEqual([]);
+    });
+    it('loads a single valid intent', async () => {
+        const intentDir = path.join(repoPath, 'intents', 'echo');
+        await mkdir(intentDir, { recursive: true });
+        await writeFile(path.join(intentDir, 'intent.ts'), `export default {
+        id: 'echo',
+        regex: /^echo (.+)$/,
+        async handle(ctx) { return {}; },
+      };`);
+        const intents = await loadIntents(repoPath);
+        expect(intents).toHaveLength(1);
+        expect(intents[0].id).toBe('echo');
+        expect(intents[0].regex.source).toBe('^echo (.+)$');
+    });
+    it('loads multiple intents alphabetically sorted', async () => {
+        for (const id of ['banana', 'apple', 'cherry']) {
+            const intentDir = path.join(repoPath, 'intents', id);
+            await mkdir(intentDir, { recursive: true });
+            await writeFile(path.join(intentDir, 'intent.ts'), `export default { id: '${id}', regex: /^${id}$/, async handle() { return {}; } };`);
+        }
+        const intents = await loadIntents(repoPath);
+        expect(intents.map((i) => i.id)).toEqual(['apple', 'banana', 'cherry']);
+    });
+    it('skips subdirs without intent.ts', async () => {
+        await mkdir(path.join(repoPath, 'intents', 'just-a-folder'), { recursive: true });
+        const intents = await loadIntents(repoPath);
+        expect(intents).toEqual([]);
+    });
+    it('skips dot- and underscore-prefixed entries', async () => {
+        for (const name of ['.hidden', '_private', '.build']) {
+            const dir = path.join(repoPath, 'intents', name);
+            await mkdir(dir, { recursive: true });
+            await writeFile(path.join(dir, 'intent.ts'), `export default { id: 'shouldnotload', regex: /^x$/, async handle() { return {}; } };`);
+        }
+        const intents = await loadIntents(repoPath);
+        expect(intents).toEqual([]);
+    });
+    it('rejects malformed default export', async () => {
+        const intentDir = path.join(repoPath, 'intents', 'bad');
+        await mkdir(intentDir, { recursive: true });
+        await writeFile(path.join(intentDir, 'intent.ts'), `export default { id: 'bad', regex: 'not-a-regex', handle: 42 };`);
+        await expect(loadIntents(repoPath)).rejects.toThrow(/IntentDefinition/);
+    });
+    it('rejects id mismatch with directory name', async () => {
+        const intentDir = path.join(repoPath, 'intents', 'directory-name');
+        await mkdir(intentDir, { recursive: true });
+        await writeFile(path.join(intentDir, 'intent.ts'), `export default { id: 'different-id', regex: /^x$/, async handle() { return {}; } };`);
+        await expect(loadIntents(repoPath)).rejects.toThrow(/must match the directory name/);
+    });
+    it('inlines sibling .ts helpers via esbuild bundle', async () => {
+        const intentDir = path.join(repoPath, 'intents', 'with-helper');
+        await mkdir(intentDir, { recursive: true });
+        await writeFile(path.join(intentDir, 'helper.ts'), `export const greeting = 'hi';`);
+        await writeFile(path.join(intentDir, 'intent.ts'), `import {greeting} from './helper.js';
+       export default {
+         id: 'with-helper',
+         regex: new RegExp('^' + greeting + '$'),
+         async handle() { return {}; },
+       };`);
+        const intents = await loadIntents(repoPath);
+        expect(intents).toHaveLength(1);
+        expect(intents[0].regex.test('hi')).toBe(true);
+    });
+});
+//# sourceMappingURL=loader.test.js.map

package/dist/src/intent/loader.test.js.map

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

package/dist/src/intent/matcher.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { IntentDefinition } from '@amodalai/types';
+/**
+ * Result of a successful intent match. The runtime hands this to the
+ * bypass executor (`runIntent`) which builds the IntentContext, calls
+ * the handler, and emits the SSE event sequence.
+ */
+export interface IntentMatch {
+    intent: IntentDefinition;
+    match: RegExpExecArray;
+}
+/**
+ * Walk the intent list in registration order and return the first
+ * regex match against `input`. Returns null when nothing matches —
+ * the caller falls through to the agent loop.
+ *
+ * "First match wins" is intentional: there's no priority field and no
+ * tie-breaking. If two intents would match the same input, the one
+ * loaded earlier wins. Intent authors keep regexes precise + anchored
+ * (`^...$`) to avoid surprises.
+ */
+export declare function matchIntent(intents: readonly IntentDefinition[], input: string): IntentMatch | null;

package/dist/src/intent/matcher.js

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Walk the intent list in registration order and return the first
+ * regex match against `input`. Returns null when nothing matches —
+ * the caller falls through to the agent loop.
+ *
+ * "First match wins" is intentional: there's no priority field and no
+ * tie-breaking. If two intents would match the same input, the one
+ * loaded earlier wins. Intent authors keep regexes precise + anchored
+ * (`^...$`) to avoid surprises.
+ */
+export function matchIntent(intents, input) {
+    for (const intent of intents) {
+        // Reset lastIndex defensively in case the regex was authored
+        // with the /g flag (which would make exec() stateful and
+        // produce the wrong results across multiple matches).
+        intent.regex.lastIndex = 0;
+        const match = intent.regex.exec(input);
+        if (match) {
+            return { intent, match };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=matcher.js.map

package/dist/src/intent/matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../../../src/intent/matcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,OAAoC,EACpC,KAAa;IAEb,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,6DAA6D;QAC7D,yDAAyD;QACzD,sDAAsD;QACtD,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,EAAC,MAAM,EAAE,KAAK,EAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/intent/matcher.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};

package/dist/src/intent/matcher.test.js

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect } from 'vitest';
+import { matchIntent } from './matcher.js';
+const noopHandle = async () => null;
+function intent(id, regex) {
+    return { id, regex, handle: noopHandle };
+}
+describe('matchIntent', () => {
+    it('returns null when no intent matches', () => {
+        const intents = [intent('a', /^hello$/), intent('b', /^world$/)];
+        expect(matchIntent(intents, 'unrelated')).toBeNull();
+    });
+    it('matches and exposes capture groups', () => {
+        const intents = [intent('install', /^Set up template '(.+)'\.?$/)];
+        const result = matchIntent(intents, "Set up template 'marketing-digest'.");
+        expect(result).not.toBeNull();
+        expect(result?.intent.id).toBe('install');
+        expect(result?.match[1]).toBe('marketing-digest');
+    });
+    it('first match wins when multiple intents would match', () => {
+        const intents = [
+            intent('first', /^hello (.+)$/),
+            intent('second', /^hello world$/),
+        ];
+        const result = matchIntent(intents, 'hello world');
+        expect(result?.intent.id).toBe('first');
+        expect(result?.match[1]).toBe('world');
+    });
+    it('treats unanchored regexes literally — author responsibility', () => {
+        // "matchIntent" itself doesn't enforce anchoring, but unanchored
+        // regexes are surprising. This test documents the behavior:
+        // "say hello to me" matches /hello/ even though probably not
+        // what the author wanted.
+        const intents = [intent('hello', /hello/)];
+        const result = matchIntent(intents, 'say hello to me');
+        expect(result?.intent.id).toBe('hello');
+    });
+    it('resets lastIndex on /g-flagged regexes so repeated calls work', () => {
+        // Defensive: a global regex with state would otherwise produce
+        // null on the second call.
+        const intents = [intent('global', /^hello$/g)];
+        expect(matchIntent(intents, 'hello')?.intent.id).toBe('global');
+        expect(matchIntent(intents, 'hello')?.intent.id).toBe('global');
+    });
+    it('handles an empty intent list', () => {
+        expect(matchIntent([], 'anything')).toBeNull();
+    });
+});
+//# sourceMappingURL=matcher.test.js.map

package/dist/src/intent/matcher.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.test.js","sourceRoot":"","sources":["../../../src/intent/matcher.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAC,MAAM,QAAQ,CAAC;AAE5C,OAAO,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAEzC,MAAM,UAAU,GAAG,KAAK,IAAmB,EAAE,CAAC,IAAI,CAAC;AAEnD,SAAS,MAAM,CAAC,EAAU,EAAE,KAAa;IACvC,OAAO,EAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAC,CAAC;AACzC,CAAC;AAED,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,EAAE,qCAAqC,CAAC,CAAC;QAC3E,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,OAAO,GAAG;YACd,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC;YAC/B,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC;SAClC,CAAC;QACF,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,iEAAiE;QACjE,4DAA4D;QAC5D,6DAA6D;QAC7D,0BAA0B;QAC1B,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,+DAA+D;QAC/D,2BAA2B;QAC3B,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChE,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/intent/onboarding.e2e.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};