@voicethere/agent 0.2.17 → 0.3.0

package/dist/templates/index.d.ts

@@ -0,0 +1,19 @@
+import { type AgentTemplateDefinition, type TemplateKind } from "./registry.js";
+export type { AgentTemplateDefinition, AgentTemplateId, TemplateKind, } from "./registry.js";
+export { AGENT_TEMPLATES, getTemplateById, isAgentTemplateId, listSeedOnCreateTemplates, } from "./registry.js";
+export interface TemplateSourceFile {
+    /** Project-relative path within the template tree (e.g. `agent.ts`, `world-layout.ts`). */
+    path: string;
+    content: string;
+}
+export interface ListTemplatesFilter {
+    kind?: TemplateKind;
+}
+export declare function listTemplates(filter?: ListTemplatesFilter): AgentTemplateDefinition[];
+export declare function getTemplate(id: string): AgentTemplateDefinition;
+export declare function resolveTemplateEntryPath(id: string): string;
+export declare function loadTemplateSources(id: string): TemplateSourceFile[];
+export declare function hasSeedBundle(id: string): boolean;
+export declare function loadTemplateBundle(id: string): Buffer;
+export declare function buildSeedTemplateBundles(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EAGlB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,kBAAkB;IACjC,2FAA2F;IAC3F,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAaD,wBAAgB,aAAa,CAC3B,MAAM,CAAC,EAAE,mBAAmB,GAC3B,uBAAuB,EAAE,CAK3B;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,CAE/D;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAYpE;AAMD,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAMjD;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAYrD;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAS9D"}

package/dist/templates/index.js

@@ -0,0 +1,77 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { buildAgentBundle } from "../build-bundle.js";
+import { AGENT_TEMPLATES, getTemplateById, listSeedOnCreateTemplates, } from "./registry.js";
+export { AGENT_TEMPLATES, getTemplateById, isAgentTemplateId, listSeedOnCreateTemplates, } from "./registry.js";
+const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
+const PACKAGE_ROOT = join(MODULE_DIR, "..", "..");
+const TEMPLATES_DIR = join(PACKAGE_ROOT, "templates");
+function toProjectRelativeSourcePath(sourceFile) {
+    if (sourceFile.includes("/")) {
+        return sourceFile.split("/").pop() ?? sourceFile;
+    }
+    return sourceFile;
+}
+export function listTemplates(filter) {
+    if (!filter?.kind) {
+        return [...AGENT_TEMPLATES];
+    }
+    return AGENT_TEMPLATES.filter((template) => template.kind === filter.kind);
+}
+export function getTemplate(id) {
+    return getTemplateById(id);
+}
+export function resolveTemplateEntryPath(id) {
+    const template = getTemplateById(id);
+    const entryPath = join(TEMPLATES_DIR, template.entry);
+    if (!existsSync(entryPath)) {
+        throw new Error(`Template entry not found for ${id}: ${entryPath}`);
+    }
+    return resolve(entryPath);
+}
+export function loadTemplateSources(id) {
+    const template = getTemplateById(id);
+    return template.sourceFiles.map((sourceFile) => {
+        const absolutePath = join(TEMPLATES_DIR, sourceFile);
+        if (!existsSync(absolutePath)) {
+            throw new Error(`Template source not found for ${id}: ${absolutePath}`);
+        }
+        return {
+            path: toProjectRelativeSourcePath(sourceFile),
+            content: readFileSync(absolutePath, "utf8"),
+        };
+    });
+}
+function seedBundlePath(id) {
+    return join(PACKAGE_ROOT, "dist", "templates", id, "agent.js");
+}
+export function hasSeedBundle(id) {
+    const template = getTemplateById(id);
+    if (!template.seedOnCreate) {
+        return false;
+    }
+    return existsSync(seedBundlePath(id));
+}
+export function loadTemplateBundle(id) {
+    const template = getTemplateById(id);
+    if (!template.seedOnCreate) {
+        throw new Error(`Template ${id} does not publish a seed bundle`);
+    }
+    const bundlePath = seedBundlePath(id);
+    if (!existsSync(bundlePath)) {
+        throw new Error(`Missing prebuilt seed bundle for ${id}. Run npm run build in @voicethere/agent.`);
+    }
+    return readFileSync(bundlePath);
+}
+export async function buildSeedTemplateBundles() {
+    for (const template of listSeedOnCreateTemplates()) {
+        const outfile = seedBundlePath(template.id);
+        await buildAgentBundle({
+            cwd: PACKAGE_ROOT,
+            entry: join("templates", template.entry),
+            outfile,
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

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

package/dist/templates/registry.d.ts

@@ -0,0 +1,18 @@
+export type TemplateKind = "product" | "e2e";
+export interface AgentTemplateDefinition {
+    id: string;
+    /** Path relative to `templates/` (e.g. `echo.ts`, `redis-sync/agent.ts`). */
+    entry: string;
+    kind: TemplateKind;
+    /** When true, a prebuilt bundle is published at `dist/templates/<id>/agent.js`. */
+    seedOnCreate: boolean;
+    description: string;
+    /** All TypeScript sources for this template (project-relative paths). */
+    sourceFiles: string[];
+}
+export declare const AGENT_TEMPLATES: readonly AgentTemplateDefinition[];
+export type AgentTemplateId = (typeof AGENT_TEMPLATES)[number]["id"];
+export declare function isAgentTemplateId(id: string): id is AgentTemplateId;
+export declare function getTemplateById(id: string): AgentTemplateDefinition;
+export declare function listSeedOnCreateTemplates(): AgentTemplateDefinition[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/templates/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/templates/registry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,KAAK,CAAC;AAE7C,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,CAAC;IACnB,mFAAmF;IACnF,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,eAAe,EAAE,SAAS,uBAAuB,EAyEpD,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAMrE,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,eAAe,CAEnE;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,CAMnE;AAED,wBAAgB,yBAAyB,IAAI,uBAAuB,EAAE,CAErE"}

package/dist/templates/registry.js

@@ -0,0 +1,81 @@
+export const AGENT_TEMPLATES = [
+    {
+        id: "echo",
+        entry: "echo.ts",
+        kind: "product",
+        seedOnCreate: true,
+        description: "Full echo debug agent — voice finals and DataChannel chat with TTS playback.",
+        sourceFiles: ["echo.ts"],
+    },
+    {
+        id: "echo-dc",
+        entry: "echo-dc.ts",
+        kind: "product",
+        seedOnCreate: true,
+        description: "Data-channel-only echo — relays speech events and chat without TTS.",
+        sourceFiles: ["echo-dc.ts"],
+    },
+    {
+        id: "voice-starter",
+        entry: "agent.ts",
+        kind: "product",
+        seedOnCreate: true,
+        description: "Voice starter covering every speech event — customize onUserSpeechFinal for your LLM.",
+        sourceFiles: ["agent.ts"],
+    },
+    {
+        id: "game-sync",
+        entry: "game-sync.ts",
+        kind: "product",
+        seedOnCreate: true,
+        description: "Authoritative multi-object sync sample for real-time games and simulations.",
+        sourceFiles: ["game-sync.ts"],
+    },
+    {
+        id: "echo-smoke",
+        entry: "echo-smoke.ts",
+        kind: "e2e",
+        seedOnCreate: false,
+        description: "Minimal echo agent for e2e voice-smoke, agent-smoke, and cli-smoke uploads.",
+        sourceFiles: ["echo-smoke.ts"],
+    },
+    {
+        id: "crash",
+        entry: "crash.ts",
+        kind: "e2e",
+        seedOnCreate: false,
+        description: "Crash / echo agent for session-errors-smoke and agent-crash-policy smokes.",
+        sourceFiles: ["crash.ts"],
+    },
+    {
+        id: "game-sync-smoke",
+        entry: "game-sync-smoke.ts",
+        kind: "e2e",
+        seedOnCreate: false,
+        description: "Minimal data-channel agent for deploy-smoke, shared-child, and idle smokes.",
+        sourceFiles: ["game-sync-smoke.ts"],
+    },
+    {
+        id: "redis-sync",
+        entry: "redis-sync/agent.ts",
+        kind: "e2e",
+        seedOnCreate: false,
+        description: "Redis-backed world buffer sync for redis-sync-smoke (Advanced tier + project Redis).",
+        sourceFiles: ["redis-sync/agent.ts", "redis-sync/world-layout.ts"],
+    },
+];
+const TEMPLATE_BY_ID = new Map(AGENT_TEMPLATES.map((template) => [template.id, template]));
+export function isAgentTemplateId(id) {
+    return TEMPLATE_BY_ID.has(id);
+}
+export function getTemplateById(id) {
+    const template = TEMPLATE_BY_ID.get(id);
+    if (!template) {
+        throw new Error(`Unknown agent template id: ${id}`);
+    }
+    return template;
+}
+export function listSeedOnCreateTemplates() {
+    return AGENT_TEMPLATES.filter((template) => template.seedOnCreate);
+}
+//# sourceMappingURL=registry.js.map

package/dist/templates/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/templates/registry.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,eAAe,GAAuC;IACjE;QACE,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;QACf,YAAY,EAAE,IAAI;QAClB,WAAW,EACT,8EAA8E;QAChF,WAAW,EAAE,CAAC,SAAS,CAAC;KACzB;IACD;QACE,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,SAAS;QACf,YAAY,EAAE,IAAI;QAClB,WAAW,EACT,qEAAqE;QACvE,WAAW,EAAE,CAAC,YAAY,CAAC;KAC5B;IACD;QACE,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,SAAS;QACf,YAAY,EAAE,IAAI;QAClB,WAAW,EACT,uFAAuF;QACzF,WAAW,EAAE,CAAC,UAAU,CAAC;KAC1B;IACD;QACE,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,cAAc;QACrB,IAAI,EAAE,SAAS;QACf,YAAY,EAAE,IAAI;QAClB,WAAW,EACT,6EAA6E;QAC/E,WAAW,EAAE,CAAC,cAAc,CAAC;KAC9B;IACD;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,KAAK;QACX,YAAY,EAAE,KAAK;QACnB,WAAW,EACT,6EAA6E;QAC/E,WAAW,EAAE,CAAC,eAAe,CAAC;KAC/B;IACD;QACE,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,KAAK;QACX,YAAY,EAAE,KAAK;QACnB,WAAW,EACT,4EAA4E;QAC9E,WAAW,EAAE,CAAC,UAAU,CAAC;KAC1B;IACD;QACE,EAAE,EAAE,iBAAiB;QACrB,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,KAAK;QACX,YAAY,EAAE,KAAK;QACnB,WAAW,EACT,6EAA6E;QAC/E,WAAW,EAAE,CAAC,oBAAoB,CAAC;KACpC;IACD;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,KAAK;QACX,YAAY,EAAE,KAAK;QACnB,WAAW,EACT,sFAAsF;QACxF,WAAW,EAAE,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;KACnE;CACO,CAAC;AAIX,MAAM,cAAc,GAAG,IAAI,GAAG,CAC5B,eAAe,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAC3D,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,OAAO,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AACrE,CAAC"}