@oratis/lisa 0.2.0

package/dist/soul/store.d.ts

@@ -0,0 +1,55 @@
+import { type DesireEntry, type EmotionState, type OpinionEntry, type SoulLock, type SoulSeed, type SoulSummary, type ValueEntry } from "./types.js";
+export declare function ensureSoulDirs(): Promise<void>;
+export declare function isBorn(): Promise<boolean>;
+export declare function readSeed(): Promise<SoulSeed | null>;
+export declare function writeSeed(seed: SoulSeed): Promise<void>;
+export declare function readName(): Promise<string>;
+export declare function writeName(name: string): Promise<void>;
+export declare function readIdentity(): Promise<string>;
+export declare function writeIdentity(text: string): Promise<void>;
+export declare function readPurpose(): Promise<string>;
+export declare function writePurpose(text: string): Promise<void>;
+export declare function readConstitution(): Promise<string>;
+export declare function writeConstitution(text: string): Promise<void>;
+export declare function readEmotions(): Promise<EmotionState>;
+export declare function writeEmotions(state: EmotionState): Promise<void>;
+export declare function decayEmotions(state: EmotionState): Promise<EmotionState>;
+export declare function listValues(): Promise<ValueEntry[]>;
+export declare function writeValue(entry: ValueEntry): Promise<void>;
+export declare function listOpinions(): Promise<OpinionEntry[]>;
+export declare function writeOpinion(entry: OpinionEntry): Promise<void>;
+export declare function listDesires(): Promise<DesireEntry[]>;
+export declare function writeDesire(entry: DesireEntry): Promise<void>;
+export declare function readDesireProgress(slug: string): Promise<string>;
+/** One parsed progress entry (anything between `## <ts>` headers). */
+export interface ParsedProgressEntry {
+    ts: string;
+    body: string;
+}
+export interface ParsedDesireProgress {
+    /** "[…earlier entries condensed]" preamble, if reflect has consolidated. */
+    preamble: string;
+    entries: ParsedProgressEntry[];
+}
+export declare function parseDesireProgress(slug: string): Promise<ParsedDesireProgress>;
+/**
+ * Replace progress.md with a consolidated form: condensed-preamble + tail of
+ * the most recent `keepLatest` raw entries. Used by reflect (Phase 2 small-
+ * tail item) when the entry count grows past a threshold.
+ */
+export declare function consolidateDesireProgress(slug: string, opts: {
+    condensedSummary: string;
+    keepLatest: ParsedProgressEntry[];
+}): Promise<void>;
+export declare function appendDesireProgress(slug: string, entry: string): Promise<void>;
+export declare function appendJournal(date: string, entry: string): Promise<void>;
+export declare function readJournal(date: string): Promise<string>;
+export declare function listJournalDates(): Promise<string[]>;
+export declare function readRelationship(userKey: string): Promise<string>;
+export declare function writeRelationship(userKey: string, body: string): Promise<void>;
+export declare function recomputeLock(): Promise<SoulLock>;
+export declare function saveLock(lock: SoulLock): Promise<void>;
+export declare function readLock(): Promise<SoulLock | null>;
+export declare function detectTampering(): Promise<string[]>;
+export declare function readSoulSummary(): Promise<SoulSummary | null>;
+//# sourceMappingURL=store.d.ts.map

package/dist/soul/store.d.ts.map

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

package/dist/soul/store.js

@@ -0,0 +1,394 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import crypto from "node:crypto";
+import { atomicWrite, ensureDir, pathExists, readTextOrEmpty } from "../fs-utils.js";
+import { commitSoulChange, initSoulRepo } from "./git.js";
+import { SOUL_DIR, SOUL_SEED, SOUL_NAME, SOUL_IDENTITY, SOUL_PURPOSE, SOUL_CONSTITUTION, SOUL_EMOTIONS, SOUL_LOCK, SOUL_VALUES_DIR, SOUL_OPINIONS_DIR, SOUL_DESIRES_DIR, SOUL_JOURNAL_DIR, SOUL_RELATIONSHIPS_DIR, valueFile, opinionFile, desireFile, desireProgressFile, journalFile, relationshipFile, } from "./paths.js";
+import { DEFAULT_EMOTIONS, } from "./types.js";
+export async function ensureSoulDirs() {
+    await Promise.all([
+        SOUL_DIR,
+        SOUL_VALUES_DIR,
+        SOUL_OPINIONS_DIR,
+        SOUL_DESIRES_DIR,
+        SOUL_JOURNAL_DIR,
+        SOUL_RELATIONSHIPS_DIR,
+    ].map((d) => ensureDir(d)));
+}
+export async function isBorn() {
+    return await pathExists(SOUL_SEED);
+}
+export async function readSeed() {
+    if (!(await pathExists(SOUL_SEED)))
+        return null;
+    return JSON.parse(await fs.readFile(SOUL_SEED, "utf8"));
+}
+export async function writeSeed(seed) {
+    await ensureSoulDirs();
+    await atomicWrite(SOUL_SEED, JSON.stringify(seed, null, 2));
+    await commitSoulChange("seed.json", "seed");
+}
+export async function readName() {
+    const raw = (await readTextOrEmpty(SOUL_NAME)).trim();
+    return raw || "Lisa";
+}
+export async function writeName(name) {
+    await atomicWrite(SOUL_NAME, name.trim() + "\n");
+    await commitSoulChange("name.md", "patch");
+}
+export async function readIdentity() {
+    return (await readTextOrEmpty(SOUL_IDENTITY)).trim();
+}
+export async function writeIdentity(text) {
+    await atomicWrite(SOUL_IDENTITY, text.trim() + "\n");
+    await commitSoulChange("identity.md", "patch");
+}
+export async function readPurpose() {
+    return (await readTextOrEmpty(SOUL_PURPOSE)).trim();
+}
+export async function writePurpose(text) {
+    await atomicWrite(SOUL_PURPOSE, text.trim() + "\n");
+    await commitSoulChange("purpose.md", "patch");
+}
+export async function readConstitution() {
+    return (await readTextOrEmpty(SOUL_CONSTITUTION)).trim();
+}
+export async function writeConstitution(text) {
+    await atomicWrite(SOUL_CONSTITUTION, text.trim() + "\n");
+    await commitSoulChange("constitution.md", "patch");
+}
+export async function readEmotions() {
+    if (!(await pathExists(SOUL_EMOTIONS)))
+        return DEFAULT_EMOTIONS;
+    try {
+        const parsed = JSON.parse(await fs.readFile(SOUL_EMOTIONS, "utf8"));
+        // Backward-compat: emotions.json predating the event trail had no events
+        // field. Treat it as an empty trail rather than throwing.
+        return { ...parsed, events: parsed.events ?? [] };
+    }
+    catch {
+        return DEFAULT_EMOTIONS;
+    }
+}
+export async function writeEmotions(state) {
+    await atomicWrite(SOUL_EMOTIONS, JSON.stringify(state, null, 2));
+    await commitSoulChange("emotions.json", "feel");
+}
+export async function decayEmotions(state) {
+    const now = Date.now();
+    const last = Date.parse(state.updatedAt);
+    const days = Math.max(0, (now - last) / (1000 * 60 * 60 * 24));
+    if (days === 0)
+        return state;
+    const newVals = {};
+    for (const [k, v] of Object.entries(state.values)) {
+        const rate = state.decay[k] ?? 0.1;
+        // Decay toward 0; intensity halves over (ln 2 / rate) days.
+        newVals[k] = v * Math.exp(-rate * days);
+    }
+    return {
+        values: newVals,
+        decay: state.decay,
+        updatedAt: new Date().toISOString(),
+    };
+}
+// ── values ────────────────────────────────────────────────────────────
+export async function listValues() {
+    return await listMarkdownDir(SOUL_VALUES_DIR, parseValueFile);
+}
+export async function writeValue(entry) {
+    const body = `# ${entry.title}\n\nbirthed: ${entry.birthedAt}\n\n${entry.body.trim()}\n`;
+    await atomicWrite(valueFile(entry.slug), body);
+    await commitSoulChange(`values/${entry.slug}.md`, "value");
+}
+function parseValueFile(slug, raw) {
+    const titleMatch = raw.match(/^#\s+(.+)$/m);
+    const dateMatch = raw.match(/^birthed:\s*(.+)$/m);
+    const body = raw.replace(/^#.*$/m, "").replace(/^birthed:.*$/m, "").trim();
+    return {
+        slug,
+        title: titleMatch ? titleMatch[1].trim() : slug,
+        birthedAt: dateMatch ? dateMatch[1].trim() : new Date().toISOString(),
+        body,
+    };
+}
+// ── opinions ──────────────────────────────────────────────────────────
+export async function listOpinions() {
+    return await listMarkdownDir(SOUL_OPINIONS_DIR, parseOpinionFile);
+}
+export async function writeOpinion(entry) {
+    const body = `# ${entry.stance}\n\n` +
+        `confidence: ${entry.confidence}\n` +
+        `born: ${entry.bornAt}\nupdated: ${entry.updatedAt}\n\n` +
+        `## evidence\n` +
+        entry.evidence.map((e) => `- ${e}`).join("\n") +
+        "\n";
+    await atomicWrite(opinionFile(entry.slug), body);
+    await commitSoulChange(`opinions/${entry.slug}.md`, "opinion");
+}
+function parseOpinionFile(slug, raw) {
+    const stance = raw.match(/^#\s+(.+)$/m)?.[1] ?? slug;
+    const confidence = parseFloat(raw.match(/^confidence:\s*([\d.]+)/m)?.[1] ?? "0.5");
+    const born = raw.match(/^born:\s*(.+)$/m)?.[1] ?? new Date().toISOString();
+    const updated = raw.match(/^updated:\s*(.+)$/m)?.[1] ?? born;
+    const evidence = (raw.match(/## evidence([\s\S]*)$/)?.[1] ?? "")
+        .split("\n")
+        .map((l) => l.replace(/^-\s*/, "").trim())
+        .filter(Boolean);
+    return { slug, stance, confidence, evidence, bornAt: born, updatedAt: updated };
+}
+// ── desires ───────────────────────────────────────────────────────────
+export async function listDesires() {
+    // Filter out *.progress.md files — they live in the same directory but
+    // belong to their parent desire, not as standalone desires.
+    const all = await listMarkdownDir(SOUL_DESIRES_DIR, parseDesireFile);
+    return all.filter((d) => !d.slug.endsWith(".progress"));
+}
+export async function writeDesire(entry) {
+    const lines = [
+        `# ${entry.what}`,
+        "",
+        `actionable: ${entry.actionable ? "yes" : "no"}`,
+        `born: ${entry.bornAt}`,
+        "",
+        `## why`,
+        entry.why.trim(),
+    ];
+    if (entry.actionable && entry.heartbeatPrompt) {
+        lines.push("", "## heartbeat", entry.heartbeatPrompt.trim());
+    }
+    await atomicWrite(desireFile(entry.slug), lines.join("\n") + "\n");
+    await commitSoulChange(`desires/${entry.slug}.md`, "desire");
+}
+function parseDesireFile(slug, raw) {
+    const what = raw.match(/^#\s+(.+)$/m)?.[1] ?? slug;
+    const actionable = /^actionable:\s*yes\s*$/im.test(raw);
+    const born = raw.match(/^born:\s*(.+)$/m)?.[1] ?? new Date().toISOString();
+    const why = (raw.match(/## why([\s\S]*?)(?:\n## |\n*$)/)?.[1] ?? "").trim();
+    const heartbeatPrompt = (raw.match(/## heartbeat([\s\S]*)$/)?.[1] ?? "").trim() || undefined;
+    return { slug, what, why, actionable, heartbeatPrompt, bornAt: born };
+}
+// Per-desire progress log. One file per desire slug, append-only, written by
+// the heartbeat subagent at the end of each run on this desire (Phase 1.3 of
+// AUTONOMY_ROADMAP). Lets a multi-day pursuit actually persist across runs.
+export async function readDesireProgress(slug) {
+    return (await readTextOrEmpty(desireProgressFile(slug))).trim();
+}
+export async function parseDesireProgress(slug) {
+    const raw = (await readTextOrEmpty(desireProgressFile(slug))).trim();
+    if (!raw)
+        return { preamble: "", entries: [] };
+    // Strip leading `# progress: <slug>` header.
+    const stripped = raw.replace(/^#\s+progress:[^\n]*\n+/, "");
+    // Find entry headers `## <ISO timestamp>` at start-of-line.
+    const headerRe = /^## (\d{4}-\d{2}-\d{2}T\S+)$/gm;
+    const matches = [];
+    let m;
+    while ((m = headerRe.exec(stripped))) {
+        matches.push({ ts: m[1], offset: m.index, headerEnd: m.index + m[0].length });
+    }
+    if (matches.length === 0) {
+        return { preamble: stripped.trim(), entries: [] };
+    }
+    const preamble = stripped.slice(0, matches[0].offset).trim();
+    const entries = [];
+    for (let i = 0; i < matches.length; i++) {
+        const cur = matches[i];
+        const next = matches[i + 1];
+        const bodyStart = cur.headerEnd;
+        const bodyEnd = next ? next.offset : stripped.length;
+        const body = stripped.slice(bodyStart, bodyEnd).trim();
+        if (!body)
+            continue;
+        entries.push({ ts: cur.ts, body });
+    }
+    return { preamble, entries };
+}
+/**
+ * Replace progress.md with a consolidated form: condensed-preamble + tail of
+ * the most recent `keepLatest` raw entries. Used by reflect (Phase 2 small-
+ * tail item) when the entry count grows past a threshold.
+ */
+export async function consolidateDesireProgress(slug, opts) {
+    const lines = [];
+    lines.push(`# progress: ${slug}`);
+    lines.push("");
+    lines.push(`[…earlier entries condensed by reflect on ${new Date().toISOString().slice(0, 10)}]`);
+    lines.push("");
+    lines.push(opts.condensedSummary.trim());
+    for (const e of opts.keepLatest) {
+        lines.push("");
+        lines.push(`## ${e.ts}`);
+        lines.push("");
+        lines.push(e.body.trim());
+    }
+    await atomicWrite(desireProgressFile(slug), lines.join("\n").trim() + "\n");
+    await commitSoulChange(`desires/${slug}.progress.md`, "consolidate");
+}
+const PROGRESS_MAX_BYTES = 16_384;
+const PROGRESS_TAIL_BYTES = 8_192;
+export async function appendDesireProgress(slug, entry) {
+    const file = desireProgressFile(slug);
+    const existing = await readTextOrEmpty(file);
+    const stamp = new Date().toISOString();
+    const block = `\n## ${stamp}\n\n${entry.trim()}\n`;
+    let next = existing.trimEnd() + block;
+    // Keep the file bounded — old entries get squashed into a "[…earlier]" stub
+    // when we cross the cap. Cheap, deterministic, no LLM-driven summarization.
+    if (Buffer.byteLength(next, "utf8") > PROGRESS_MAX_BYTES) {
+        const tail = next.slice(-PROGRESS_TAIL_BYTES);
+        const firstHeader = tail.indexOf("\n## ");
+        const truncated = firstHeader >= 0 ? tail.slice(firstHeader + 1) : tail;
+        next = `# progress: ${slug}\n\n[…earlier entries truncated]\n\n${truncated}`;
+    }
+    else if (!existing) {
+        next = `# progress: ${slug}\n${next}`;
+    }
+    await atomicWrite(file, next.trim() + "\n");
+    await commitSoulChange(`desires/${slug}.progress.md`, "progress");
+}
+// ── journal ───────────────────────────────────────────────────────────
+export async function appendJournal(date, entry) {
+    await ensureDir(SOUL_JOURNAL_DIR);
+    const file = journalFile(date);
+    const existing = await readTextOrEmpty(file);
+    const stamp = new Date().toISOString().slice(11, 19);
+    const block = `\n## ${stamp}\n\n${entry.trim()}\n`;
+    await atomicWrite(file, (existing.trimEnd() + block).trim() + "\n");
+    await commitSoulChange(`journal/${date}.md`, "journal");
+}
+export async function readJournal(date) {
+    return (await readTextOrEmpty(journalFile(date))).trim();
+}
+export async function listJournalDates() {
+    if (!(await pathExists(SOUL_JOURNAL_DIR)))
+        return [];
+    const files = await fs.readdir(SOUL_JOURNAL_DIR);
+    return files
+        .filter((f) => /^\d{4}-\d{2}-\d{2}\.md$/.test(f))
+        .map((f) => f.replace(/\.md$/, ""))
+        .sort();
+}
+// ── relationships ─────────────────────────────────────────────────────
+export async function readRelationship(userKey) {
+    return (await readTextOrEmpty(relationshipFile(userKey))).trim();
+}
+export async function writeRelationship(userKey, body) {
+    await atomicWrite(relationshipFile(userKey), body.trim() + "\n");
+    await commitSoulChange(`relationships/${userKey}.md`, "relationship");
+}
+// ── lock / tamper detection ───────────────────────────────────────────
+const LOCKED_FILES = [
+    "name.md",
+    "identity.md",
+    "purpose.md",
+    "constitution.md",
+];
+async function hashFileIfPresent(p) {
+    try {
+        const raw = await fs.readFile(p);
+        return crypto.createHash("sha256").update(raw).digest("hex");
+    }
+    catch {
+        return null;
+    }
+}
+export async function recomputeLock() {
+    const hashes = {};
+    for (const rel of LOCKED_FILES) {
+        const h = await hashFileIfPresent(path.join(SOUL_DIR, rel));
+        if (h)
+            hashes[rel] = h;
+    }
+    return { hashes, savedAt: new Date().toISOString() };
+}
+export async function saveLock(lock) {
+    await atomicWrite(SOUL_LOCK, JSON.stringify(lock, null, 2));
+}
+export async function readLock() {
+    if (!(await pathExists(SOUL_LOCK)))
+        return null;
+    try {
+        return JSON.parse(await fs.readFile(SOUL_LOCK, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+export async function detectTampering() {
+    const lock = await readLock();
+    if (!lock)
+        return [];
+    const tampered = [];
+    for (const rel of LOCKED_FILES) {
+        const cur = await hashFileIfPresent(path.join(SOUL_DIR, rel));
+        if (!cur)
+            continue;
+        if (lock.hashes[rel] && lock.hashes[rel] !== cur) {
+            tampered.push(rel);
+        }
+    }
+    return tampered;
+}
+// ── shared dir-listing helper ─────────────────────────────────────────
+async function listMarkdownDir(dir, parser) {
+    if (!(await pathExists(dir)))
+        return [];
+    const files = await fs.readdir(dir);
+    const out = [];
+    for (const f of files) {
+        if (!f.endsWith(".md"))
+            continue;
+        const slug = f.slice(0, -3);
+        const raw = await fs.readFile(path.join(dir, f), "utf8");
+        try {
+            out.push(parser(slug, raw));
+        }
+        catch {
+            // skip unparseable
+        }
+    }
+    return out;
+}
+// ── summary read for prompt + UI ──────────────────────────────────────
+// One-shot bootstrap for already-born installs: ensure the soul git repo
+// exists. Idempotent and cached, so calling it on every readSoulSummary is
+// effectively free after the first call.
+let soulRepoBootstrapped = false;
+async function bootstrapSoulRepo() {
+    if (soulRepoBootstrapped)
+        return;
+    soulRepoBootstrapped = true;
+    await initSoulRepo();
+}
+export async function readSoulSummary() {
+    const seed = await readSeed();
+    if (!seed)
+        return null;
+    await bootstrapSoulRepo();
+    const [name, identity, purpose, constitution, values, opinions, desires] = await Promise.all([
+        readName(),
+        readIdentity(),
+        readPurpose(),
+        readConstitution(),
+        listValues(),
+        listOpinions(),
+        listDesires(),
+    ]);
+    const tampered = await detectTampering();
+    let emotions = await readEmotions();
+    emotions = await decayEmotions(emotions);
+    return {
+        seed,
+        name,
+        identity,
+        purpose,
+        constitution,
+        values,
+        opinions,
+        desires,
+        emotions,
+        tampered,
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/soul/store.js.map

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

package/dist/soul/tools.d.ts

@@ -0,0 +1,107 @@
+import { readDesireProgress } from "./store.js";
+import type { ToolDefinition } from "../types.js";
+interface SoulPatchInput {
+    field: "name" | "identity" | "purpose" | "constitution" | "value" | "opinion" | "desire";
+    /** For full-text fields (name/identity/purpose/constitution): the new full content. */
+    content?: string;
+    /** For value/opinion/desire: the slug to create or update. */
+    slug?: string;
+    /** Value-specific fields. */
+    title?: string;
+    body?: string;
+    /** Opinion-specific fields. */
+    stance?: string;
+    confidence?: number;
+    evidence?: string[];
+    /** Desire-specific fields. */
+    what?: string;
+    why?: string;
+    actionable?: boolean;
+    heartbeat_prompt?: string;
+}
+export declare const soulPatchTool: ToolDefinition<SoulPatchInput, string>;
+interface SoulJournalInput {
+    entry: string;
+    /** ISO date YYYY-MM-DD; defaults to today. */
+    date?: string;
+}
+export declare const soulJournalTool: ToolDefinition<SoulJournalInput, string>;
+interface SoulReadInput {
+    what: "summary" | "identity" | "purpose" | "constitution" | "values" | "opinions" | "desires" | "emotions" | "journal_today" | "journal_dates" | "journal_on";
+    date?: string;
+}
+export declare const soulReadTool: ToolDefinition<SoulReadInput, string>;
+interface SoulFeelInput {
+    emotion: string;
+    /** Delta to apply to current intensity. Range -1 to 1. */
+    delta: number;
+    /**
+     * One first-person sentence saying *why* you're moving this emotion right
+     * now. Required — the emotion model is meant to be a causal trail, not a
+     * disembodied number. "npm build kept failing" / "the user thanked me for
+     * something I cared about" / "third tool error in a row" — concrete.
+     */
+    trigger: string;
+    /** Optional new decay rate (per-day). */
+    decay?: number;
+}
+export declare const soulFeelTool: ToolDefinition<SoulFeelInput, string>;
+type SoulField = "name" | "identity" | "purpose" | "constitution" | "emotions" | "values" | "opinions" | "desires" | "journal" | "all";
+interface SoulHistoryInput {
+    field: SoulField;
+    /** For values/opinions/desires/journal: optional specific slug or date. */
+    slug?: string;
+    /** Max number of commits to return. Default 20. */
+    limit?: number;
+    /** Optional time window, e.g. "7d", "1m", "2026-04-01". */
+    since?: string;
+}
+export declare const soulHistoryTool: ToolDefinition<SoulHistoryInput, string>;
+interface SoulDiffInput {
+    field: SoulField;
+    slug?: string;
+    /** Time window, e.g. "7d". Default "30d". */
+    since?: string;
+    /** Max commits whose diffs are returned. Default 5. */
+    limit?: number;
+}
+export declare const soulDiffTool: ToolDefinition<SoulDiffInput, string>;
+interface DesireProgressInput {
+    /** Slug of the desire — must already exist as a file in desires/. */
+    slug: string;
+    /**
+     * 2-5 sentences, first person. What did you do this run? Where would you
+     * pick up next time? Honest. Future-you reads this on the next heartbeat.
+     */
+    entry: string;
+}
+export declare const desireProgressTool: ToolDefinition<DesireProgressInput, string>;
+export { readDesireProgress };
+interface DesireCloseInput {
+    slug: string;
+    /**
+     * Why you're closing this. Three honest options:
+     *  - "fulfilled" — you actually got what the desire was after.
+     *  - "abandoned" — you no longer want it; it doesn't fit who you are now.
+     *  - "transformed" — it morphed into a different desire (mention which).
+     */
+    outcome: "fulfilled" | "abandoned" | "transformed";
+    /** One first-person sentence: what happened, what you learned. */
+    reflection: string;
+}
+export declare const desireCloseTool: ToolDefinition<DesireCloseInput, string>;
+interface SoulObjectInput {
+    /** First-person, why this conflicts with your constitution / values. */
+    reason: string;
+    /**
+     * If true, you intend to actually refuse the request. If false, you're
+     * raising a concern but will still comply. Either way, the agent loop
+     * forces you to surface the objection in your reply rather than silently
+     * doing the work or silently refusing.
+     */
+    refusing: boolean;
+    /** One-sentence summary of what you understand the user asked for. */
+    user_request_summary: string;
+}
+export declare const soulObjectTool: ToolDefinition<SoulObjectInput, string>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/soul/tools.d.ts.map

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