p-spore 0.1.0

package/dist/settings/llm-settings-service.js

@@ -0,0 +1,199 @@
+import { access, mkdir, mkdtemp, readFile, rm, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { ModelRuntime } from "@earendil-works/pi-coding-agent";
+import { parseConfig } from "../config/config.js";
+import { atomicWriteFile, atomicWriteJson } from "../storage/atomic.js";
+import { loadConfig } from "../storage/home.js";
+import { decodeLlmSettingsUpdate, PROVIDER_OPTIONS, } from "./llm-settings.js";
+const DEFAULT_PROVIDER = "deepseek";
+const DEFAULT_MODEL = "deepseek-v4-flash";
+const MAX_MODELS_FILE_BYTES = 1_048_576;
+const SUPPORTED_APIS = new Set([
+    "openai-completions",
+    "openai-responses",
+    "anthropic-messages",
+    "google-generative-ai",
+]);
+export class LlmSettingsService {
+    #home;
+    #paths;
+    constructor(home, paths) {
+        this.#home = home;
+        this.#paths = paths;
+    }
+    async get() {
+        const config = await loadConfig(this.#home);
+        const provider = providerOption(config.model?.provider ?? DEFAULT_PROVIDER);
+        const model = config.model?.model ?? DEFAULT_MODEL;
+        const models = await this.#readModels();
+        const providerConfig = record(models.providers[provider]);
+        const api = modelApi(providerConfig?.["api"]);
+        const customModel = Array.isArray(providerConfig?.["models"])
+            && providerConfig["models"].some((candidate) => record(candidate)?.["id"] === model);
+        return {
+            version: 1,
+            provider,
+            model,
+            baseUrl: typeof providerConfig?.["baseUrl"] === "string" ? providerConfig["baseUrl"] : "",
+            api,
+            thinking: config.model?.thinking ?? "off",
+            customModel,
+            hasApiKey: await this.#hasApiKey(provider, providerConfig),
+        };
+    }
+    async save(update) {
+        update = decodeLlmSettingsUpdate(update);
+        const currentConfig = await loadConfig(this.#home);
+        const models = await this.#readModels();
+        const providerConfig = { ...(record(models.providers[update.provider]) ?? {}) };
+        const credentialPath = this.#credentialPath(update.provider);
+        const credentialExists = await exists(credentialPath);
+        if (update.baseUrl)
+            providerConfig["baseUrl"] = update.baseUrl;
+        else
+            delete providerConfig["baseUrl"];
+        if (update.customModel) {
+            providerConfig["api"] = update.api;
+            providerConfig["models"] = upsertCustomModel(providerConfig["models"], update.model);
+        }
+        else {
+            if (update.api === "provider-default")
+                delete providerConfig["api"];
+            else
+                providerConfig["api"] = update.api;
+            const remainingModels = removeCustomModel(providerConfig["models"], update.model);
+            if (Array.isArray(remainingModels) && remainingModels.length > 0)
+                providerConfig["models"] = remainingModels;
+            else
+                delete providerConfig["models"];
+        }
+        if (update.apiKey || (credentialExists && !update.clearApiKey)) {
+            providerConfig["apiKey"] = credentialCommand(credentialPath);
+        }
+        else if (update.clearApiKey && isManagedCredentialCommand(providerConfig["apiKey"], credentialPath)) {
+            delete providerConfig["apiKey"];
+        }
+        const nextModels = { ...models, providers: { ...models.providers } };
+        if (Object.keys(providerConfig).length > 0)
+            nextModels.providers[update.provider] = providerConfig;
+        else
+            delete nextModels.providers[update.provider];
+        const nextConfig = parseConfig({
+            ...currentConfig,
+            model: { provider: update.provider, model: update.model, thinking: update.thinking },
+        }, this.#home);
+        await this.#validateModel(nextModels, update.provider, update.model);
+        if (update.apiKey) {
+            await mkdir(this.#paths.credentials, { recursive: true, mode: 0o700 });
+            await atomicWriteFile(credentialPath, update.apiKey, 0o600);
+        }
+        await atomicWriteJson(join(this.#paths.agentDir, "models.json"), nextModels, 0o600);
+        await atomicWriteJson(this.#paths.config, nextConfig, 0o600);
+        if (update.clearApiKey)
+            await unlink(credentialPath).catch(ignoreMissingFile);
+        return this.get();
+    }
+    async #readModels() {
+        const path = join(this.#paths.agentDir, "models.json");
+        let source;
+        try {
+            source = await readFile(path, "utf8");
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === "ENOENT")
+                return { providers: {} };
+            throw error;
+        }
+        if (Buffer.byteLength(source, "utf8") > MAX_MODELS_FILE_BYTES) {
+            throw new Error("models.json is too large to edit safely from pSpore settings");
+        }
+        const parsed = JSON.parse(source);
+        const root = record(parsed);
+        const providers = record(root?.["providers"]);
+        if (!root || !providers)
+            throw new Error("models.json must contain a providers object");
+        return { ...root, providers };
+    }
+    async #validateModel(models, provider, model) {
+        const temporaryDirectory = await mkdtemp(join(this.#paths.agentDir, ".settings-validate-"));
+        try {
+            const modelsPath = join(temporaryDirectory, "models.json");
+            const authPath = join(temporaryDirectory, "auth.json");
+            await atomicWriteJson(modelsPath, models, 0o600);
+            await atomicWriteJson(authPath, {}, 0o600);
+            const runtime = await ModelRuntime.create({ authPath, modelsPath, refreshOnCreate: false });
+            if (!runtime.getModel(provider, model)) {
+                throw new Error(`Model ${provider}/${model} is not built in; enable custom model and select a compatible API`);
+            }
+            const compositionError = runtime.getError();
+            if (compositionError)
+                throw new Error(`Model configuration is invalid: ${compositionError}`);
+        }
+        finally {
+            await rm(temporaryDirectory, { recursive: true, force: true });
+        }
+    }
+    async #hasApiKey(provider, providerConfig) {
+        if (await exists(this.#credentialPath(provider)))
+            return true;
+        return typeof providerConfig?.["apiKey"] === "string" && providerConfig["apiKey"].length > 0;
+    }
+    #credentialPath(provider) {
+        return join(this.#paths.credentials, `${provider}.api-key`);
+    }
+}
+function upsertCustomModel(value, model) {
+    const models = Array.isArray(value) ? [...value] : [];
+    const index = models.findIndex((candidate) => record(candidate)?.["id"] === model);
+    const current = index >= 0 ? (record(models[index]) ?? {}) : {};
+    const next = { ...current, id: model, name: typeof current["name"] === "string" ? current["name"] : model };
+    if (index >= 0)
+        models[index] = next;
+    else
+        models.push(next);
+    return models;
+}
+function removeCustomModel(value, model) {
+    if (!Array.isArray(value))
+        return value;
+    return value.filter((candidate) => record(candidate)?.["id"] !== model);
+}
+function modelApi(value) {
+    return typeof value === "string" && SUPPORTED_APIS.has(value) ? value : "provider-default";
+}
+function providerOption(value) {
+    if (PROVIDER_OPTIONS.includes(value))
+        return value;
+    throw new Error(`Unsupported provider ${value}; choose deepseek, openai, or custom-openai`);
+}
+function credentialCommand(path) {
+    return `!cat -- ${shellQuote(path)}`;
+}
+function isManagedCredentialCommand(value, path) {
+    return value === credentialCommand(path);
+}
+function shellQuote(value) {
+    return `'${value.replaceAll("'", `'"'"'`)}'`;
+}
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
+function ignoreMissingFile(error) {
+    if (!isNodeError(error) || error.code !== "ENOENT")
+        throw error;
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=llm-settings-service.js.map

package/dist/settings/llm-settings-service.js.map

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

package/dist/settings/llm-settings.d.ts

@@ -0,0 +1,29 @@
+export type ModelApi = "provider-default" | "openai-completions" | "openai-responses" | "anthropic-messages" | "google-generative-ai";
+export type ThinkingLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+export type ProviderOption = "deepseek" | "openai" | "custom-openai";
+export interface LlmSettings {
+    version: 1;
+    provider: ProviderOption;
+    model: string;
+    baseUrl: string;
+    api: ModelApi;
+    thinking: ThinkingLevel;
+    customModel: boolean;
+    hasApiKey: boolean;
+}
+export interface LlmSettingsUpdate {
+    provider: ProviderOption;
+    model: string;
+    baseUrl: string;
+    api: ModelApi;
+    thinking: ThinkingLevel;
+    customModel: boolean;
+    apiKey?: string;
+    clearApiKey: boolean;
+}
+export declare const MODEL_APIS: readonly ModelApi[];
+export declare const THINKING_LEVELS: readonly ThinkingLevel[];
+export declare const PROVIDER_OPTIONS: readonly ProviderOption[];
+export declare function defaultModelFor(provider: ProviderOption): string;
+export declare function decodeLlmSettingsUpdate(value: unknown, label?: string): LlmSettingsUpdate;
+//# sourceMappingURL=llm-settings.d.ts.map

package/dist/settings/llm-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-settings.d.ts","sourceRoot":"","sources":["../../src/settings/llm-settings.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAChB,kBAAkB,GAClB,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,sBAAsB,CAAC;AAE3B,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAC5F,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,eAAe,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,QAAQ,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,QAAQ,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAMzC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAAgE,CAAC;AACrH,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAA4C,CAAC;AAEnG,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAIhE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAiB,GAAG,iBAAiB,CA2CjG"}

package/dist/settings/llm-settings.js

@@ -0,0 +1,113 @@
+export const MODEL_APIS = [
+    "provider-default",
+    "openai-completions",
+    "openai-responses",
+    "anthropic-messages",
+    "google-generative-ai",
+];
+export const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+export const PROVIDER_OPTIONS = ["deepseek", "openai", "custom-openai"];
+export function defaultModelFor(provider) {
+    if (provider === "deepseek")
+        return "deepseek-v4-flash";
+    if (provider === "openai")
+        return "gpt-5.6-terra";
+    return "custom-model";
+}
+export function decodeLlmSettingsUpdate(value, label = "LLM settings") {
+    const input = object(value, label);
+    exactShape(input, ["provider", "model", "baseUrl", "api", "thinking", "customModel", "clearApiKey"], ["apiKey"], label);
+    const provider = enumeration(input["provider"], PROVIDER_OPTIONS, `${label}.provider`);
+    const model = modelIdentifier(input["model"], `${label}.model`, true);
+    const baseUrl = optionalString(input["baseUrl"], `${label}.baseUrl`, 2_048);
+    if (baseUrl)
+        validateBaseUrl(baseUrl, label);
+    const customModel = booleanValue(input["customModel"], `${label}.customModel`);
+    const api = enumeration(input["api"], MODEL_APIS, `${label}.api`);
+    if (provider === "custom-openai" && !customModel)
+        throw new Error(`${label}.customModel must be enabled for custom-openai`);
+    if (provider !== "custom-openai" && customModel)
+        throw new Error(`${label}.customModel is only available for custom-openai`);
+    if (provider === "custom-openai" && api !== "openai-completions" && api !== "openai-responses") {
+        throw new Error(`${label}.api must be an OpenAI-compatible API for custom-openai`);
+    }
+    if (provider !== "custom-openai" && (baseUrl || api !== "provider-default")) {
+        throw new Error(`${label} only allows Base URL and API overrides for custom-openai`);
+    }
+    if (customModel && !baseUrl)
+        throw new Error(`${label}.baseUrl is required for a custom model`);
+    if (customModel && api === "provider-default")
+        throw new Error(`${label}.api must be selected for a custom model`);
+    const apiKeyValue = input["apiKey"];
+    let apiKey;
+    if (apiKeyValue !== undefined) {
+        apiKey = optionalString(apiKeyValue, `${label}.apiKey`, 16_384);
+        if (!apiKey)
+            apiKey = undefined;
+        if (apiKey && /[\r\n\u0000]/.test(apiKey))
+            throw new Error(`${label}.apiKey cannot contain line breaks`);
+    }
+    const clearApiKey = booleanValue(input["clearApiKey"], `${label}.clearApiKey`);
+    if (apiKey && clearApiKey)
+        throw new Error(`${label} cannot set and clear the API key together`);
+    return {
+        provider,
+        model,
+        baseUrl,
+        api,
+        thinking: enumeration(input["thinking"], THINKING_LEVELS, `${label}.thinking`),
+        customModel,
+        ...(apiKey ? { apiKey } : {}),
+        clearApiKey,
+    };
+}
+function object(value, path) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        throw new Error(`${path} must be an object`);
+    return value;
+}
+function exactShape(value, required, optional, path) {
+    const allowed = new Set([...required, ...optional]);
+    const unknown = Object.keys(value).filter((key) => !allowed.has(key));
+    if (unknown.length > 0)
+        throw new Error(`${path} contains unknown fields: ${unknown.join(", ")}`);
+    for (const key of required)
+        if (!(key in value))
+            throw new Error(`${path}.${key} is required`);
+}
+function optionalString(value, path, maximum) {
+    if (typeof value !== "string" || value.length > maximum || /[\u0000]/.test(value)) {
+        throw new Error(`${path} must be a string of at most ${maximum} characters`);
+    }
+    return value.trim();
+}
+function booleanValue(value, path) {
+    if (typeof value !== "boolean")
+        throw new Error(`${path} must be boolean`);
+    return value;
+}
+function modelIdentifier(value, path, allowSlash) {
+    const identifier = optionalString(value, path, 128);
+    const expression = allowSlash ? /^[A-Za-z0-9][A-Za-z0-9._:/-]*$/ : /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+    if (!identifier || !expression.test(identifier))
+        throw new Error(`${path} contains unsupported characters`);
+    return identifier;
+}
+function enumeration(value, allowed, path) {
+    if (typeof value !== "string" || !allowed.includes(value))
+        throw new Error(`${path} must be one of: ${allowed.join(", ")}`);
+    return value;
+}
+function validateBaseUrl(value, label) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Error(`${label}.baseUrl must be a valid URL`);
+    }
+    if ((url.protocol !== "https:" && url.protocol !== "http:") || url.username || url.password || url.search || url.hash) {
+        throw new Error(`${label}.baseUrl must be an HTTP(S) URL without credentials, query, or fragment`);
+    }
+}
+//# sourceMappingURL=llm-settings.js.map

package/dist/settings/llm-settings.js.map

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

package/dist/shell/shell-service.d.ts

@@ -0,0 +1,88 @@
+export type ShellMode = "pipe" | "pty";
+export type ShellStream = "stdout" | "stderr";
+export interface ShellRequest {
+    command: string;
+    cwd: string;
+    envDelta?: Readonly<Record<string, string>>;
+    mode: ShellMode;
+    timeoutMs: number;
+    maxOutputBytes: number;
+}
+export interface ShellChunk {
+    processId: string;
+    stream: ShellStream;
+    data: string;
+    ts: string;
+}
+export interface ShellResult {
+    processId: string;
+    pid: number;
+    shell: string;
+    mode: ShellMode;
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    durationMs: number;
+    timedOut: boolean;
+    aborted: boolean;
+    outputLimitExceeded: boolean;
+    stdout: string;
+    stderr: string;
+    capturedBytes: number;
+    artifactPath: string;
+    artifactSha256: string;
+}
+export interface ShellProcessStatus {
+    processId: string;
+    pid: number;
+    state: "running" | "settled";
+    capturedBytes: number;
+    startedAt: string;
+}
+export interface ShellProcessHandle {
+    readonly id: string;
+    readonly pid: number;
+    readonly completion: Promise<ShellResult>;
+    write(data: string | Uint8Array, options?: {
+        secret?: boolean;
+    }): Promise<void>;
+    signal(signal: NodeJS.Signals): void;
+    poll(): ShellProcessStatus;
+}
+export interface ResolvedShell {
+    path: string;
+    source: "config" | "environment" | "passwd" | "fallback";
+}
+export interface ResolveShellOptions {
+    configuredShell?: string;
+    env?: NodeJS.ProcessEnv;
+    uid?: number;
+    passwdPath?: string;
+}
+export interface ShellServiceOptions {
+    artifactRoot: string;
+    configuredShell?: string;
+    env?: NodeJS.ProcessEnv;
+    passwdPath?: string;
+    scriptPath?: string;
+    clock?: () => Date;
+    idFactory?: () => string;
+    summaryBytesPerStream?: number;
+}
+export declare class ShellService {
+    #private;
+    constructor(options: ShellServiceOptions);
+    initialize(): Promise<ResolvedShell>;
+    doctor(): Promise<{
+        shell: ResolvedShell;
+        pipe: true;
+        pty: {
+            available: boolean;
+            scriptPath?: string;
+        };
+    }>;
+    run(request: ShellRequest, onChunk?: (chunk: ShellChunk) => void): Promise<ShellResult>;
+    start(request: ShellRequest, onChunk?: (chunk: ShellChunk) => void): Promise<ShellProcessHandle>;
+}
+export declare function resolveUserShell(options?: ResolveShellOptions): Promise<ResolvedShell>;
+export declare function shellDisplayName(path: string): string;
+//# sourceMappingURL=shell-service.d.ts.map

package/dist/shell/shell-service.d.ts.map

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