@oratis/lisa 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,67 @@
+import type Anthropic from "@anthropic-ai/sdk";
+export type Role = "user" | "assistant";
+export interface ToolDefinition<TInput = unknown, TOutput = unknown> {
+    name: string;
+    description: string;
+    inputSchema: Anthropic.Tool.InputSchema;
+    execute(input: TInput, ctx: ToolContext): Promise<TOutput>;
+    renderResultForModel?(result: TOutput): string;
+}
+export interface ToolContext {
+    cwd: string;
+    signal: AbortSignal;
+    log: (msg: string) => void;
+    /**
+     * Set by the agent loop. soul_object calls this to register an
+     * architectural objection that must be surfaced in Lisa's reply
+     * before the turn is considered closed. (Phase 2.1)
+     */
+    onObjection?: (o: {
+        reason: string;
+        refusing: boolean;
+        userRequestSummary: string;
+    }) => void;
+}
+export type StoredMessage = Anthropic.MessageParam;
+export interface SkillFrontmatter {
+    name: string;
+    description: string;
+    version?: string;
+    tags?: string[];
+}
+export interface Skill {
+    frontmatter: SkillFrontmatter;
+    body: string;
+    path: string;
+}
+export interface SessionHeader {
+    type: "session";
+    id: string;
+    version: 1;
+    startedAt: string;
+    cwd: string;
+    model: string;
+}
+export type SessionEntry = {
+    type: "message";
+    ts: string;
+    message: StoredMessage;
+} | {
+    type: "model_change";
+    ts: string;
+    model: string;
+} | {
+    type: "reflection";
+    ts: string;
+    summary: string;
+};
+export interface AgentEvent {
+    type: "turn_start" | "text_delta" | "thinking_delta" | "tool_call_start" | "tool_call_end" | "turn_end" | "error" | "info" | "system_prompt_rebuilt";
+    text?: string;
+    toolName?: string;
+    toolInput?: unknown;
+    toolResult?: unknown;
+    isError?: boolean;
+    message?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAE/C,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,WAAW,CAAC;AAExC,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC;IACxC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,oBAAoB,CAAC,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC9F;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,YAAY,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,KAAK;IACpB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,IAAI,EACA,YAAY,GACZ,YAAY,GACZ,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,GACf,UAAU,GACV,OAAO,GACP,MAAM,GACN,uBAAuB,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/voice/speak.d.ts

@@ -0,0 +1,7 @@
+export interface SpeakOptions {
+    text: string;
+    voice?: string;
+    rate?: number;
+}
+export declare function speak(opts: SpeakOptions): Promise<void>;
+//# sourceMappingURL=speak.d.ts.map

package/dist/voice/speak.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speak.d.ts","sourceRoot":"","sources":["../../src/voice/speak.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAe7D"}

package/dist/voice/speak.js

@@ -0,0 +1,18 @@
+import { spawn } from "node:child_process";
+export async function speak(opts) {
+    if (process.platform !== "darwin") {
+        throw new Error("speak() currently only supports macOS (uses /usr/bin/say)");
+    }
+    return await new Promise((resolve, reject) => {
+        const args = [];
+        if (opts.voice)
+            args.push("-v", opts.voice);
+        if (opts.rate)
+            args.push("-r", String(opts.rate));
+        args.push(opts.text);
+        const child = spawn("/usr/bin/say", args);
+        child.on("error", reject);
+        child.on("close", (code) => code === 0 ? resolve() : reject(new Error(`say exited ${code}`)));
+    });
+}
+//# sourceMappingURL=speak.js.map

package/dist/voice/speak.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speak.js","sourceRoot":"","sources":["../../src/voice/speak.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAQ3C,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAkB;IAC5C,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACjD,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAC1C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CACzB,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CACjE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/voice/tool.d.ts

@@ -0,0 +1,14 @@
+import type { ToolDefinition } from "../types.js";
+interface SpeakInput {
+    text: string;
+    voice?: string;
+    rate?: number;
+}
+export declare const speakTool: ToolDefinition<SpeakInput, string>;
+interface TranscribeInput {
+    audio_path: string;
+    model?: string;
+}
+export declare const transcribeTool: ToolDefinition<TranscribeInput, string>;
+export {};
+//# sourceMappingURL=tool.d.ts.map

package/dist/voice/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/voice/tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,UAAU,EAAE,MAAM,CAkBxD,CAAC;AAEF,UAAU,eAAe;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,eAAe,EAAE,MAAM,CAkBlE,CAAC"}

package/dist/voice/tool.js

@@ -0,0 +1,41 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { transcribeAudio } from "./transcribe.js";
+import { speak } from "./speak.js";
+export const speakTool = {
+    name: "speak",
+    description: "Read text aloud through the macOS speech synthesizer (`/usr/bin/say`). " +
+        "Use sparingly — only when the user is in a voice / hands-free context.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            text: { type: "string" },
+            voice: { type: "string" },
+            rate: { type: "integer", minimum: 80, maximum: 400 },
+        },
+        required: ["text"],
+    },
+    async execute(input) {
+        await speak(input);
+        return `spoke ${input.text.length} chars`;
+    },
+};
+export const transcribeTool = {
+    name: "transcribe",
+    description: "Transcribe an audio file (m4a/mp3/wav/etc.) using OpenAI Whisper. " +
+        "Requires OPENAI_API_KEY. Returns the transcript text.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            audio_path: { type: "string" },
+            model: { type: "string", default: "whisper-1" },
+        },
+        required: ["audio_path"],
+    },
+    async execute(input, ctx) {
+        const abs = path.resolve(ctx.cwd, input.audio_path);
+        await fs.access(abs);
+        return await transcribeAudio({ audioPath: abs, model: input.model });
+    },
+};
+//# sourceMappingURL=tool.js.map

package/dist/voice/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/voice/tool.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAQnC,MAAM,CAAC,MAAM,SAAS,GAAuC;IAC3D,IAAI,EAAE,OAAO;IACb,WAAW,EACT,yEAAyE;QACzE,wEAAwE;IAC1E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE;SACrD;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO,SAAS,KAAK,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC;IAC5C,CAAC;CACF,CAAC;AAOF,MAAM,CAAC,MAAM,cAAc,GAA4C;IACrE,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,oEAAoE;QACpE,uDAAuD;IACzD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE;SAChD;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;IACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QACpD,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,OAAO,MAAM,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACvE,CAAC;CACF,CAAC"}

package/dist/voice/transcribe.d.ts

@@ -0,0 +1,7 @@
+export interface TranscribeOptions {
+    audioPath: string;
+    model?: string;
+    apiKey?: string;
+}
+export declare function transcribeAudio(opts: TranscribeOptions): Promise<string>;
+//# sourceMappingURL=transcribe.d.ts.map

package/dist/voice/transcribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribe.d.ts","sourceRoot":"","sources":["../../src/voice/transcribe.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAY9E"}

package/dist/voice/transcribe.js

@@ -0,0 +1,14 @@
+import fs from "node:fs";
+import OpenAI from "openai";
+export async function transcribeAudio(opts) {
+    if (!process.env.OPENAI_API_KEY && !opts.apiKey) {
+        throw new Error("Voice transcription needs OPENAI_API_KEY (uses OpenAI Whisper).");
+    }
+    const client = new OpenAI({ apiKey: opts.apiKey });
+    const result = await client.audio.transcriptions.create({
+        model: opts.model ?? "whisper-1",
+        file: fs.createReadStream(opts.audioPath),
+    });
+    return result.text;
+}
+//# sourceMappingURL=transcribe.js.map

package/dist/voice/transcribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribe.js","sourceRoot":"","sources":["../../src/voice/transcribe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAQ5B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAuB;IAC3D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC;QACtD,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,WAAW;QAChC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC;KAC1C,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}