everybuddy 0.1.0

package/dist/soul/providers/anthropic.d.ts

@@ -0,0 +1,17 @@
+import type { AIProvider } from "./types.js";
+export interface AnthropicProviderOptions {
+    apiKey: string;
+    model: string;
+    baseUrl?: string | undefined;
+    systemPrompt?: string | undefined;
+    requestTimeoutMs?: number | undefined;
+}
+export declare class AnthropicProvider implements AIProvider {
+    readonly modelId: string;
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly systemPrompt;
+    private readonly requestTimeoutMs;
+    constructor(options: AnthropicProviderOptions);
+    complete(prompt: string): Promise<string>;
+}

package/dist/soul/providers/anthropic.js

@@ -0,0 +1,105 @@
+const DEFAULT_BASE_URL = "https://api.anthropic.com";
+const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+const ANTHROPIC_VERSION = "2023-06-01";
+const DEFAULT_SYSTEM_PROMPT = "You create concise terminal companion metadata. Follow the user request exactly and return only the requested JSON.";
+export class AnthropicProvider {
+    modelId;
+    apiKey;
+    baseUrl;
+    systemPrompt;
+    requestTimeoutMs;
+    constructor(options) {
+        this.modelId = options.model;
+        this.apiKey = options.apiKey;
+        this.baseUrl = normalizeBaseUrl(options.baseUrl);
+        this.systemPrompt = options.systemPrompt?.trim() || DEFAULT_SYSTEM_PROMPT;
+        this.requestTimeoutMs = normalizeTimeoutMs(options.requestTimeoutMs);
+    }
+    async complete(prompt) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => {
+            controller.abort();
+        }, this.requestTimeoutMs);
+        let response;
+        try {
+            response = await fetch(`${this.baseUrl}/v1/messages`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "x-api-key": this.apiKey,
+                    "anthropic-version": ANTHROPIC_VERSION,
+                },
+                body: JSON.stringify({
+                    model: this.modelId,
+                    max_tokens: 1024,
+                    system: this.systemPrompt,
+                    messages: [{ role: "user", content: prompt }],
+                }),
+                signal: controller.signal,
+            });
+        }
+        catch (error) {
+            if (isAbortError(error)) {
+                throw new Error(`Provider request timed out after ${Math.ceil(this.requestTimeoutMs / 1000)}s.`);
+            }
+            throw new Error(`Provider request failed: ${getErrorMessage(error)}`);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+        const payload = (await response.json().catch(async () => {
+            const text = await response.text();
+            throw new Error(`Provider returned invalid JSON: ${text}`);
+        }));
+        if (!response.ok) {
+            throw new Error(`Provider request failed (${response.status} ${response.statusText}): ${extractErrorMessage(payload)}`);
+        }
+        const content = payload.content;
+        const text = Array.isArray(content) &&
+            content.length > 0 &&
+            typeof content[0] === "object" &&
+            content[0] !== null &&
+            "text" in content[0] &&
+            typeof content[0].text === "string"
+            ? content[0].text
+            : undefined;
+        if (!text || text.trim().length === 0) {
+            throw new Error("Provider returned an empty response.");
+        }
+        return text;
+    }
+}
+function normalizeBaseUrl(value) {
+    const normalized = value?.trim() || DEFAULT_BASE_URL;
+    return normalized.replace(/\/+$/, "");
+}
+function normalizeTimeoutMs(value) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        return DEFAULT_REQUEST_TIMEOUT_MS;
+    }
+    return Math.floor(value);
+}
+function isAbortError(error) {
+    return ((error instanceof DOMException && error.name === "AbortError") ||
+        (typeof error === "object" &&
+            error !== null &&
+            "name" in error &&
+            error.name === "AbortError"));
+}
+function extractErrorMessage(value) {
+    if (typeof value === "object" && value !== null) {
+        const record = value;
+        const error = record.error;
+        if (typeof error === "object" && error !== null && "message" in error) {
+            const message = error.message;
+            if (typeof message === "string" && message.trim().length > 0) {
+                return message;
+            }
+        }
+    }
+    return "unknown provider error";
+}
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/soul/providers/anthropic.js.map

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

package/dist/soul/providers/index.d.ts

@@ -0,0 +1,10 @@
+import type { BuddyProvider } from "../../types/companion.js";
+import type { AIProvider } from "./types.js";
+export interface CreateProviderParams {
+    provider: BuddyProvider;
+    apiKey: string;
+    model: string;
+    baseUrl?: string | undefined;
+    systemPrompt?: string | undefined;
+}
+export declare function createProvider(params: CreateProviderParams): AIProvider;

package/dist/soul/providers/index.js

@@ -0,0 +1,23 @@
+import { AnthropicProvider } from "./anthropic.js";
+import { OpenAICompatibleProvider } from "./openai.js";
+export function createProvider(params) {
+    switch (params.provider) {
+        case "anthropic":
+            return new AnthropicProvider({
+                apiKey: params.apiKey,
+                model: params.model,
+                baseUrl: params.baseUrl,
+                systemPrompt: params.systemPrompt,
+            });
+        case "openai":
+        case "custom":
+        default:
+            return new OpenAICompatibleProvider({
+                apiKey: params.apiKey,
+                model: params.model,
+                baseUrl: params.baseUrl,
+                systemPrompt: params.systemPrompt,
+            });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/soul/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/soul/providers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAWvD,MAAM,UAAU,cAAc,CAAC,MAA4B;IACzD,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,WAAW;YACd,OAAO,IAAI,iBAAiB,CAAC;gBAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,YAAY,EAAE,MAAM,CAAC,YAAY;aAClC,CAAC,CAAC;QACL,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd;YACE,OAAO,IAAI,wBAAwB,CAAC;gBAClC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,YAAY,EAAE,MAAM,CAAC,YAAY;aAClC,CAAC,CAAC;IACP,CAAC;AACH,CAAC"}

package/dist/soul/providers/openai.d.ts

@@ -0,0 +1,20 @@
+import type { AIProvider } from "./types.js";
+export interface OpenAICompatibleProviderOptions {
+    apiKey: string;
+    model: string;
+    baseUrl?: string | undefined;
+    systemPrompt?: string | undefined;
+    requestTimeoutMs?: number | undefined;
+}
+export declare const DEFAULT_SYSTEM_PROMPT = "You create concise terminal companion metadata. Follow the user request exactly and return only the requested JSON.";
+export declare class OpenAICompatibleProvider implements AIProvider {
+    readonly modelId: string;
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly systemPrompt;
+    private readonly requestTimeoutMs;
+    private readonly disableThinking;
+    constructor(options: OpenAICompatibleProviderOptions);
+    complete(prompt: string): Promise<string>;
+}
+export declare function shouldDisableThinking(baseUrl: string): boolean;

package/dist/soul/providers/openai.js

@@ -0,0 +1,120 @@
+const DEFAULT_BASE_URL = "https://api.openai.com/v1";
+const DEFAULT_REQUEST_TIMEOUT_MS = 20_000;
+export const DEFAULT_SYSTEM_PROMPT = "You create concise terminal companion metadata. Follow the user request exactly and return only the requested JSON.";
+export class OpenAICompatibleProvider {
+    modelId;
+    apiKey;
+    baseUrl;
+    systemPrompt;
+    requestTimeoutMs;
+    disableThinking;
+    constructor(options) {
+        this.modelId = options.model;
+        this.apiKey = options.apiKey;
+        this.baseUrl = normalizeBaseUrl(options.baseUrl);
+        this.systemPrompt = options.systemPrompt?.trim() || DEFAULT_SYSTEM_PROMPT;
+        this.requestTimeoutMs = normalizeTimeoutMs(options.requestTimeoutMs);
+        this.disableThinking = shouldDisableThinking(this.baseUrl);
+    }
+    async complete(prompt) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => {
+            controller.abort();
+        }, this.requestTimeoutMs);
+        const requestBody = {
+            model: this.modelId,
+            messages: [
+                { role: "system", content: this.systemPrompt },
+                { role: "user", content: prompt },
+            ],
+        };
+        if (this.disableThinking) {
+            requestBody.enable_thinking = false;
+        }
+        let response;
+        try {
+            response = await fetch(`${this.baseUrl}/chat/completions`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify(requestBody),
+                signal: controller.signal,
+            });
+        }
+        catch (error) {
+            if (isAbortError(error)) {
+                throw new Error(`Provider request timed out after ${Math.ceil(this.requestTimeoutMs / 1000)}s.`);
+            }
+            throw new Error(`Provider request failed: ${getErrorMessage(error)}`);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+        const payload = (await response.json().catch(async () => {
+            const text = await response.text();
+            throw new Error(`Provider returned invalid JSON: ${text}`);
+        }));
+        if (!response.ok) {
+            throw new Error(`Provider request failed (${response.status} ${response.statusText}): ${extractErrorMessage(payload)}`);
+        }
+        const choices = payload.choices;
+        const content = Array.isArray(choices) &&
+            typeof choices[0] === "object" &&
+            choices[0] !== null &&
+            "message" in choices[0] &&
+            typeof choices[0].message === "object" &&
+            choices[0].message !== null &&
+            "content" in choices[0].message
+            ? choices[0].message.content
+            : undefined;
+        if (typeof content !== "string" || content.trim().length === 0) {
+            throw new Error("Provider returned an empty response.");
+        }
+        return content;
+    }
+}
+function normalizeBaseUrl(value) {
+    const normalized = value?.trim() || DEFAULT_BASE_URL;
+    return normalized.replace(/\/+$/, "");
+}
+function normalizeTimeoutMs(value) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        return DEFAULT_REQUEST_TIMEOUT_MS;
+    }
+    return Math.floor(value);
+}
+export function shouldDisableThinking(baseUrl) {
+    try {
+        const url = new URL(baseUrl);
+        return url.hostname.endsWith("dashscope.aliyuncs.com");
+    }
+    catch {
+        return false;
+    }
+}
+function isAbortError(error) {
+    return ((error instanceof DOMException && error.name === "AbortError") ||
+        (typeof error === "object" &&
+            error !== null &&
+            "name" in error &&
+            error.name === "AbortError"));
+}
+function extractErrorMessage(value) {
+    if (typeof value === "object" && value !== null) {
+        const record = value;
+        const error = record.error;
+        if (typeof error === "object" && error !== null && "message" in error) {
+            const message = error.message;
+            if (typeof message === "string" && message.trim().length > 0) {
+                return message;
+            }
+        }
+    }
+    return "unknown provider error";
+}
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=openai.js.map

package/dist/soul/providers/openai.js.map

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

package/dist/soul/providers/types.d.ts

@@ -0,0 +1,4 @@
+export interface AIProvider {
+    readonly modelId: string;
+    complete(prompt: string): Promise<string>;
+}

package/dist/soul/providers/types.js

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

package/dist/soul/providers/types.js.map

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

package/dist/storage/companion.d.ts

@@ -0,0 +1,3 @@
+import type { CompanionRecord } from "../types/companion.js";
+export declare function readCompanionRecord(storageDir?: string): Promise<CompanionRecord | null>;
+export declare function writeCompanionRecord(record: CompanionRecord, storageDir?: string): Promise<void>;

package/dist/storage/companion.js

@@ -0,0 +1,155 @@
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { DEFAULT_OBSERVER_PROFILE, parseOptionalObserverProfile } from "../soul/profile.js";
+import { companionFilePath, defaultStorageDir } from "./paths.js";
+export async function readCompanionRecord(storageDir = defaultStorageDir()) {
+    const targetPath = companionFilePath(storageDir);
+    try {
+        const raw = await readFile(targetPath, "utf8");
+        const parsed = JSON.parse(raw);
+        return parseCompanionRecord(parsed);
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            return null;
+        }
+        throw new Error(`Failed to read companion at ${targetPath}: ${getErrorMessage(error)}`);
+    }
+}
+export async function writeCompanionRecord(record, storageDir = defaultStorageDir()) {
+    const targetPath = companionFilePath(storageDir);
+    const tempPath = path.join(storageDir, `.companion.${process.pid}.${Date.now().toString(36)}.tmp`);
+    const payload = JSON.stringify(record, null, 2);
+    await mkdir(storageDir, { recursive: true });
+    await writeFile(tempPath, payload, "utf8");
+    await rename(tempPath, targetPath);
+}
+function parseCompanionRecord(value) {
+    if (!isPlainObject(value)) {
+        throw new Error("Companion file must contain a JSON object.");
+    }
+    const { templateId, userId, bones, soul, createdAt } = value;
+    if (templateId !== undefined && (typeof templateId !== "string" || templateId.trim().length === 0)) {
+        throw new Error("Companion `templateId` must be a non-empty string when present.");
+    }
+    if (typeof userId !== "string" || userId.trim().length === 0) {
+        throw new Error("Companion `userId` must be a non-empty string.");
+    }
+    if (typeof createdAt !== "string" || createdAt.trim().length === 0) {
+        throw new Error("Companion `createdAt` must be a non-empty string.");
+    }
+    return {
+        ...(typeof templateId === "string" ? { templateId: templateId.trim() } : {}),
+        userId,
+        bones: parseCompanionBones(bones),
+        soul: parseCompanionSoul(soul),
+        createdAt,
+    };
+}
+function parseCompanionBones(value) {
+    if (!isPlainObject(value)) {
+        throw new Error("Companion `bones` must be an object.");
+    }
+    const { userId, species, rarity, eye, hat, stats, color, shiny } = value;
+    if (typeof userId !== "string" || userId.trim().length === 0) {
+        throw new Error("Companion bones `userId` must be a non-empty string.");
+    }
+    if (typeof species !== "string" || species.trim().length === 0) {
+        throw new Error("Companion bones `species` must be a non-empty string.");
+    }
+    if (typeof eye !== "string" || eye.trim().length === 0) {
+        throw new Error("Companion bones `eye` must be a non-empty string.");
+    }
+    if (typeof hat !== "string" || hat.trim().length === 0) {
+        throw new Error("Companion bones `hat` must be a non-empty string.");
+    }
+    if (typeof shiny !== "boolean") {
+        throw new Error("Companion bones `shiny` must be a boolean.");
+    }
+    return {
+        userId,
+        species,
+        rarity: parseRarity(rarity),
+        eye,
+        hat,
+        stats: parseStatBlock(stats),
+        color: parseColorPalette(color),
+        shiny,
+    };
+}
+function parseCompanionSoul(value) {
+    if (!isPlainObject(value)) {
+        throw new Error("Companion `soul` must be an object.");
+    }
+    const { name, tagline, personality, modelUsed } = value;
+    const observerProfile = parseOptionalObserverProfile(value.observerProfile);
+    if (typeof name !== "string" || name.trim().length === 0) {
+        throw new Error("Companion soul `name` must be a non-empty string.");
+    }
+    if (tagline !== undefined && (typeof tagline !== "string" || tagline.trim().length === 0)) {
+        throw new Error("Companion soul `tagline` must be a non-empty string when present.");
+    }
+    if (typeof personality !== "string" || personality.trim().length === 0) {
+        throw new Error("Companion soul `personality` must be a non-empty string.");
+    }
+    if (typeof modelUsed !== "string" || modelUsed.trim().length === 0) {
+        throw new Error("Companion soul `modelUsed` must be a non-empty string.");
+    }
+    return {
+        name: name.trim(),
+        ...(typeof tagline === "string" ? { tagline: tagline.trim() } : {}),
+        personality: personality.trim(),
+        observerProfile: observerProfile ?? { ...DEFAULT_OBSERVER_PROFILE },
+        modelUsed: modelUsed.trim(),
+    };
+}
+function parseRarity(value) {
+    if (!isPlainObject(value)) {
+        throw new Error("Companion rarity must be an object.");
+    }
+    const { tier, name, stars, color, weight, floor } = value;
+    if (typeof tier !== "number" ||
+        typeof name !== "string" ||
+        typeof stars !== "string" ||
+        typeof color !== "string" ||
+        typeof weight !== "number" ||
+        typeof floor !== "number") {
+        throw new Error("Companion rarity is invalid.");
+    }
+    return { tier, name, stars, color, weight, floor };
+}
+function parseStatBlock(value) {
+    if (!isPlainObject(value)) {
+        throw new Error("Companion stats must be an object.");
+    }
+    const statNames = ["GRIT", "FOCUS", "CHAOS", "WIT", "SASS"];
+    const stats = {};
+    for (const statName of statNames) {
+        const statValue = value[statName];
+        if (typeof statValue !== "number") {
+            throw new Error(`Companion stat ${statName} must be a number.`);
+        }
+        stats[statName] = statValue;
+    }
+    return stats;
+}
+function parseColorPalette(value) {
+    if (!isPlainObject(value)) {
+        throw new Error("Companion color palette must be an object.");
+    }
+    const { primary, accent } = value;
+    if (typeof primary !== "string" || typeof accent !== "string") {
+        throw new Error("Companion color palette is invalid.");
+    }
+    return { primary, accent };
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isMissingFileError(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=companion.js.map

package/dist/storage/companion.js.map

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

package/dist/storage/config.d.ts

@@ -0,0 +1,36 @@
+import type { BuddyConfig, HatchReadyConfig, ResolvedBuddyConfig } from "../types/companion.js";
+export declare const DEFAULT_OPENAI_BASE_URL = "https://coding.dashscope.aliyuncs.com/v1";
+export declare const DEFAULT_OPENAI_MODEL = "qwen3.5-plus";
+export declare const DEFAULT_OPENAI_OBSERVER_MODEL = "qwen3-coder-next";
+export declare const DEFAULT_ANTHROPIC_BASE_URL = "https://api.anthropic.com";
+export declare const DEFAULT_ANTHROPIC_MODEL = "claude-haiku-4-5-20251001";
+export declare const DEFAULT_ANTHROPIC_OBSERVER_MODEL = "claude-haiku-4-5-20251001";
+export declare const PROVIDER_DEFAULTS: {
+    readonly openai: {
+        readonly baseUrl: "https://coding.dashscope.aliyuncs.com/v1";
+        readonly model: "qwen3.5-plus";
+        readonly observerModel: "qwen3-coder-next";
+    };
+    readonly anthropic: {
+        readonly baseUrl: "https://api.anthropic.com";
+        readonly model: "claude-haiku-4-5-20251001";
+        readonly observerModel: "claude-haiku-4-5-20251001";
+    };
+    readonly custom: {
+        readonly baseUrl: string | undefined;
+        readonly model: string | undefined;
+        readonly observerModel: string | undefined;
+    };
+};
+export interface ResolveBuddyConfigOptions {
+    model?: string | undefined;
+    apiKey?: string | undefined;
+    baseUrl?: string | undefined;
+    storageDir?: string | undefined;
+}
+export declare function resolveBuddyConfig(options?: ResolveBuddyConfigOptions): Promise<ResolvedBuddyConfig>;
+export declare function assertHatchReadyConfig(config: ResolvedBuddyConfig): HatchReadyConfig;
+export declare function resolveUserId(cliUserId?: string): string;
+export declare function readBuddyConfigFile(storageDir?: string): Promise<BuddyConfig>;
+export declare function writeBuddyConfigFile(config: BuddyConfig, storageDir?: string): Promise<void>;
+export declare function updateBuddyConfigFile(updates: BuddyConfig, storageDir?: string): Promise<BuddyConfig>;