@kuralle-syrinx/cli 4.4.1 → 4.5.0

package/dist/agent-resolve.d.ts

@@ -0,0 +1,14 @@
+import type { SessionFactory } from "./turn-runner.js";
+export interface ResolvedAgent {
+    readonly factory: SessionFactory;
+    readonly label: string;
+}
+/**
+ * `spec` is `<module>[#namedExport]`, resolved relative to `baseDir` (the
+ * invoking project's cwd) when not absolute. The export must be a zero-arg
+ * factory returning a VoiceAgentSession (or a Promise of one) — the same
+ * shape `--agent` expects in dev-server.ts. Omit `#export` for a default
+ * export (or a `createSession` export, checked in that order).
+ */
+export declare function resolveAgentFactory(spec: string, baseDir: string): Promise<ResolvedAgent>;
+//# sourceMappingURL=agent-resolve.d.ts.map

package/dist/agent-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-resolve.d.ts","sourceRoot":"","sources":["../src/agent-resolve.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA6C/F"}

package/dist/cli.d.ts

@@ -0,0 +1,8 @@
+import { type ExitCode } from "./exit-codes.js";
+export interface CliIO {
+    readonly stdout: (line: string) => void;
+    readonly stderr: (line: string) => void;
+}
+export declare const defaultIO: CliIO;
+export declare function main(argv: readonly string[], io?: CliIO): Promise<ExitCode>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AASA,OAAO,EAAyC,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAMvF,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,eAAO,MAAM,SAAS,EAAE,KAOvB,CAAC;AA2JF,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,GAAE,KAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0C5F"}

package/dist/doctor.d.ts

@@ -0,0 +1,38 @@
+/** Commonly used in the Syrinx ecosystem — shown for convenience only. The CLI itself does not require any of these; whatever --agent resolves to owns its own provider requirements. */
+export declare const WELL_KNOWN_PROVIDER_KEYS: readonly ["DEEPGRAM_API_KEY", "OPENAI_API_KEY", "CARTESIA_API_KEY", "GEMINI_API_KEY", "ELEVENLABS_API_KEY", "GROK_API_KEY"];
+export type WellKnownProviderKey = (typeof WELL_KNOWN_PROVIDER_KEYS)[number];
+export interface DoctorAgentReport {
+    readonly spec: string;
+    readonly resolved: boolean;
+    readonly label?: string;
+    readonly error?: string;
+}
+export interface DoctorReport {
+    readonly cliVersion: string;
+    readonly node: {
+        readonly version: string;
+        readonly platform: string;
+    };
+    readonly core: {
+        readonly package: string;
+        readonly resolved: boolean;
+        readonly version: string | undefined;
+        readonly cliMajor: string;
+        readonly coreMajor: string | undefined;
+        readonly majorMismatch: boolean;
+    };
+    /** Informational only — presence, never the value. This CLI does not require any specific set; see `agent`. */
+    readonly wellKnownProviderKeys: Readonly<Record<WellKnownProviderKey, boolean>>;
+    readonly agent: DoctorAgentReport | null;
+    readonly summary: string;
+}
+export interface RunDoctorOptions {
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly nodeVersion?: string;
+    readonly platform?: string;
+    /** `--agent <module>#<export>` — when given, doctor resolves (imports + finds the callable export) but does not invoke it, so checking doesn't require live provider access. */
+    readonly agentSpec?: string;
+}
+export declare function runDoctor(opts?: RunDoctorOptions): Promise<DoctorReport>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAgBA,yLAAyL;AACzL,eAAO,MAAM,wBAAwB,6HAA8H,CAAC;AAEpK,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;QACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;QACvC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;KACjC,CAAC;IACF,+GAA+G;IAC/G,QAAQ,CAAC,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,CAAC;IAChF,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,gLAAgL;IAChL,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAsB,SAAS,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CA8ClF"}

package/dist/exit-codes.d.ts

@@ -0,0 +1,21 @@
+export declare const EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly INTERNAL: 1;
+    readonly USAGE: 2;
+    readonly CONFIG: 3;
+    readonly BACKEND: 4;
+    readonly ASSERTION: 5;
+};
+export type ExitCode = (typeof EXIT_CODES)[keyof typeof EXIT_CODES];
+export declare const EXIT_CODE_TABLE: ReadonlyArray<{
+    readonly code: ExitCode;
+    readonly name: string;
+    readonly meaning: string;
+}>;
+/** A typed error carrying the exit code it should terminate the process with. */
+export declare class CliError extends Error {
+    readonly exitCode: ExitCode;
+    readonly details: Record<string, unknown> | undefined;
+    constructor(exitCode: ExitCode, message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=exit-codes.d.ts.map

package/dist/exit-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../src/exit-codes.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,UAAU;;;;;;;CAOb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEpE,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAOvH,CAAC;AAEF,iFAAiF;AACjF,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;gBAE1C,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMnF"}

package/dist/fixture.d.ts

@@ -0,0 +1,38 @@
+export declare const FIXTURE_FORMAT = "syrinx.fixture.v1";
+export interface FixtureSidecar {
+    readonly format: string;
+    readonly turnId?: string;
+    readonly expectedTranscript?: string;
+    readonly agentText?: string;
+    readonly audioFile: string;
+    readonly audio: {
+        readonly sampleRateHz: number;
+        readonly channels: number;
+        readonly encoding: string;
+    };
+    readonly capture?: {
+        readonly inputSampleRateHz?: number;
+    };
+}
+export interface LoadedFixture {
+    readonly sidecarPath: string;
+    readonly sidecar: FixtureSidecar;
+    /** The paired WAV file this fixture replays — prefers the sibling "captured.wav" the Studio actually wrote. */
+    readonly wavPath: string;
+}
+/**
+ * Parse and validate a fixture sidecar JSON file, refusing (CliError, USAGE) on
+ * anything this CLI cannot honestly replay: an unrecognised format, or capture
+ * conditions (sample rate / channel count) that would silently change the
+ * transcript if replayed as-is.
+ */
+export declare function loadFixture(sidecarPath: string): LoadedFixture;
+/** Compare on words, not punctuation — STT capitalises and punctuates inconsistently. */
+export declare function normalizeTranscript(text: string): string;
+export interface TranscriptAssertion {
+    readonly expectedTranscript: string;
+    readonly actualTranscript: string;
+    readonly match: boolean;
+}
+export declare function assertTranscript(expectedTranscript: string, actualTranscript: string): TranscriptAssertion;
+//# sourceMappingURL=fixture.d.ts.map

package/dist/fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../src/fixture.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACxG,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,+GAA+G;IAC/G,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAsC9D;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,gBAAgB,CAAC,kBAAkB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,mBAAmB,CAM1G"}

package/dist/help.d.ts

@@ -0,0 +1,2 @@
+export declare const HELP_TEXT: string;
+//# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,SAAS,QA+DrB,CAAC"}

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -82,7 +82,7 @@ import { dirname, join, resolve as resolvePath } from "node:path";
 // package.json
 var package_default = {
   name: "@kuralle-syrinx/cli",
-  version: "4.3.0",
+  version: "4.5.0",
   private: false,
   description: "Agent-facing CLI for Syrinx \u2014 run a turn or a text exchange with deterministic, machine-readable (--json) output and exit codes. Not a console: no REPL, no chat loop, no microphone.",
   keywords: [
@@ -117,9 +117,10 @@ var package_default = {
     "./turn-runner": "./src/turn-runner.ts"
   },
   scripts: {
-    build: "node scripts/build.mjs",
+    build: "node scripts/build.mjs && tsc -p tsconfig.build.json --emitDeclarationOnly",
     typecheck: "tsc --noEmit",
-    test: "vitest run"
+    test: "vitest run",
+    prepublishOnly: "node scripts/build.mjs && tsc -p tsconfig.build.json --emitDeclarationOnly"
   },
   dependencies: {
     "@kuralle-syrinx/core": "workspace:*",
@@ -131,6 +132,14 @@ var package_default = {
     esbuild: "^0.28.1",
     typescript: "^5.7.0",
     vitest: "^3.2.6"
+  },
+  publishConfig: {
+    exports: {
+      "./turn-runner": {
+        types: "./dist/turn-runner.d.ts",
+        default: "./dist/turn-runner.js"
+      }
+    }
   }
 };