deepclause-sdk 0.0.89 → 0.1.1

package/dist/repl/auth.js

@@ -0,0 +1,116 @@
+/**
+ * pi login/logout, ported to a plain terminal.
+ *
+ * This is the headless equivalent of pi's `/login`: enumerate providers with
+ * their auth methods and configured status, run `runtime.login(provider, type,
+ * interaction)` (which persists the credential), and render the auth
+ * events (`auth_url`, `device_code`, `progress`, `info`) that the flow emits.
+ *
+ * The interaction is a superset of pi-ai's `AuthInteraction`; the shapes are
+ * re-declared structurally so this module does not depend on pi-ai types.
+ */
+import * as readline from 'readline';
+function ask(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer);
+        });
+    });
+}
+function renderAuthEvent(event) {
+    if (event.type === 'auth_url' && event.url) {
+        console.log(`\nOpen this URL to authorize:\n  ${event.url}`);
+        if (event.instructions)
+            console.log(event.instructions);
+    }
+    else if (event.type === 'device_code') {
+        console.log(`\nVisit ${event.verificationUri} and enter code: ${event.userCode}`);
+    }
+    else if (event.message) {
+        console.log(event.message);
+    }
+    for (const link of event.links ?? []) {
+        console.log(`  ${link.label ?? link.url}: ${link.url}`);
+    }
+}
+/** Port of pi's login dialog to a plain terminal (readline + stdout). */
+export function createTerminalAuthInteraction() {
+    return {
+        async prompt(prompt) {
+            if (prompt.options && prompt.options.length > 0) {
+                const lines = prompt.options.map((option, index) => {
+                    const description = option.description ? ` — ${option.description}` : '';
+                    return `  ${index + 1}. ${option.label}${description}`;
+                });
+                const answer = await ask(`${prompt.message}\n${lines.join('\n')}\n> `);
+                const byIndex = Number(answer.trim()) - 1;
+                if (Number.isInteger(byIndex) && prompt.options[byIndex]) {
+                    return prompt.options[byIndex].id;
+                }
+                const byId = prompt.options.find((option) => option.id === answer.trim());
+                return byId ? byId.id : answer.trim();
+            }
+            const placeholder = prompt.placeholder ? ` (${prompt.placeholder})` : '';
+            return ask(`${prompt.message}${placeholder}\n> `);
+        },
+        notify: renderAuthEvent,
+    };
+}
+/** Interaction that answers every prompt with a fixed API key. */
+export function apiKeyInteraction(apiKey) {
+    return {
+        prompt: async () => apiKey,
+        notify: (event) => {
+            if (event.message)
+                console.log(event.message);
+        },
+    };
+}
+/**
+ * Providers that support login, one entry per auth method (mirrors pi's
+ * `getLoginProviderOptions`).
+ */
+export function listLoginProviders(handle, options = {}) {
+    const status = new Map(handle.listProviders().map((provider) => [provider.id, provider]));
+    const out = [];
+    for (const provider of handle.runtime.getProviders()) {
+        const info = status.get(provider.id);
+        const configured = info?.configured ?? handle.hasAuth(provider.id);
+        const source = info?.label ?? info?.source;
+        const subscription = provider.auth?.oauth?.isSubscription === true;
+        const base = { id: provider.id, name: provider.name ?? provider.id, configured, source, subscription };
+        if ((!options.authType || options.authType === 'oauth') && provider.auth?.oauth) {
+            out.push({ ...base, authType: 'oauth' });
+        }
+        if ((!options.authType || options.authType === 'api_key') && provider.auth?.apiKey) {
+            out.push({ ...base, authType: 'api_key' });
+        }
+    }
+    return out.sort((a, b) => a.name.localeCompare(b.name) || a.authType.localeCompare(b.authType));
+}
+/**
+ * Run pi's login for a provider. `type` selects the auth method when a provider
+ * offers both; otherwise the only available method is used. `apiKey` short-
+ * circuits the interaction.
+ */
+export async function loginToProvider(handle, providerId, options) {
+    if (options.apiKey) {
+        await handle.login(providerId, apiKeyInteraction(options.apiKey), 'api_key');
+        return;
+    }
+    const types = listLoginProviders(handle)
+        .filter((provider) => provider.id === providerId)
+        .map((provider) => provider.authType);
+    const type = options.type ?? (types.includes('api_key') ? 'api_key' : types[0]);
+    if (!type) {
+        throw new Error(`provider '${providerId}' has no login method`);
+    }
+    await handle.login(providerId, options.interaction, type);
+}
+/** Remove a stored credential (pi `/logout`). */
+export async function logoutProvider(handle, providerId) {
+    await handle.logout(providerId);
+}
+//# sourceMappingURL=auth.js.map

package/dist/repl/auth.js.map

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

package/dist/repl/backend.d.ts

@@ -0,0 +1,321 @@
+/**
+ * Backend resolution for the REPL (M5).
+ *
+ * `env` uses the SDK's provider/API-key backend (unchanged). `pi` reuses pi's
+ * own model registry and credential store so the REPL runs against the model
+ * configured in pi, without asking for API keys or writing provider env vars.
+ *
+ * The pi packages are optional peers and loaded with a dynamic import only when
+ * the pi backend is selected.
+ */
+import type { LLMBackend } from '../types.js';
+export type BackendKind = 'env' | 'pi';
+export interface PiBackendConfig {
+    kind?: BackendKind;
+    agentDir?: string;
+    modelsPath?: string | null;
+    authPath?: string | null;
+    model?: string;
+    /** Requested thinking level for reasoning models (see `ThinkingLevel`). */
+    thinkingLevel?: string;
+}
+export interface ResolvedBackendPaths {
+    agentDir: string;
+    modelsPath: string;
+    authPath: string;
+    model?: string;
+}
+/** Minimal structural view of pi's ModelRegistry used by the adapter. */
+export interface PiModelLike {
+    provider: string;
+    id: string;
+    api?: string;
+    /** Whether the model accepts a thinking/reasoning level. */
+    reasoning?: boolean;
+    /** Model compatibility flags (e.g. `supportsTemperature`). */
+    compat?: {
+        supportsTemperature?: boolean;
+        [key: string]: unknown;
+    };
+    /** Catalog price, USD per 1M tokens. */
+    cost?: {
+        input?: number;
+        output?: number;
+        cacheRead?: number;
+        cacheWrite?: number;
+    };
+    /** Model context window in tokens. */
+    contextWindow?: number;
+    /** Maximum output tokens. */
+    maxTokens?: number;
+    /** Maps pi thinking levels to provider values; `null` marks a level unsupported. */
+    thinkingLevelMap?: Partial<Record<ThinkingLevel, string | null>>;
+}
+/** pi's thinking levels, in ascending effort order. */
+export type ThinkingLevel = 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+export declare const THINKING_LEVELS: readonly ThinkingLevel[];
+/** Levels a model accepts: reasoning models expose all but explicitly-unsupported ones. */
+export declare function supportedThinkingLevels(model: PiModelLike): ThinkingLevel[];
+/**
+ * Validate a requested thinking level against the model. Returns the level to
+ * pass through (or `undefined` for the provider default) plus a warning when a
+ * request had to be dropped.
+ */
+export declare function resolveThinkingLevel(model: PiModelLike, requested?: string): {
+    level?: ThinkingLevel;
+    supported: ThinkingLevel[];
+    warning?: string;
+};
+export interface PiCompletionRequest {
+    systemPrompt?: string;
+    messages: unknown[];
+    tools?: unknown[];
+}
+export interface PiCompletionResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    } | {
+        type: 'toolCall';
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    }>;
+    usage: {
+        input: number;
+        output: number;
+        totalTokens: number;
+        cacheRead?: number;
+        cacheWrite?: number;
+        reasoning?: number;
+    };
+    stopReason: 'stop' | 'toolUse' | 'length' | 'error' | 'aborted';
+    errorMessage?: string;
+}
+export interface PiStreamEventLike {
+    type: string;
+    delta?: string;
+}
+export interface PiStreamLike extends AsyncIterable<PiStreamEventLike> {
+    result(): Promise<PiCompletionResult>;
+}
+export interface PiRegistryLike {
+    getAvailable(): PiModelLike[];
+    find?(provider: string, modelId: string): PiModelLike | undefined;
+    hasConfiguredAuth(model: PiModelLike): boolean;
+    complete(model: PiModelLike, context: PiCompletionRequest, options: unknown): Promise<PiCompletionResult>;
+    /** Streaming API; when present, `complete` forwards text/thinking deltas. */
+    streamSimple?(model: PiModelLike, context: PiCompletionRequest, options: unknown): PiStreamLike;
+}
+/** Resolve pi's agent dir, models.json, and auth.json paths. */
+export declare function resolvePiPaths(config: PiBackendConfig, defaults: {
+    agentDir: string;
+}): ResolvedBackendPaths;
+/** Select the pi model to use, honoring an explicit provider/model request. */
+export declare function selectPiModel(registry: PiRegistryLike, requested?: string): PiModelLike;
+/**
+ * Wrap a pi registry + model as an SDK `LLMBackend`. Reused by the extension
+ * embedding, which passes its live registry.
+ *
+ * `thinkingLevel` is forwarded to the provider only for reasoning models and
+ * non-`off` levels, so provider defaults are preserved for every other model.
+ */
+export declare function createPiAdapter(registry: PiRegistryLike, model: PiModelLike, maxTokens?: number, thinkingLevel?: string): {
+    backend: LLMBackend;
+    registry: PiRegistryLike;
+    modelId: string;
+    provider: string;
+    contextWindow?: number;
+    maxTokens: number;
+    reasoning: boolean;
+    thinkingLevel?: ThinkingLevel;
+    supportedThinkingLevels: ThinkingLevel[];
+    warning?: string;
+};
+export interface CreatePiBackendOptions extends PiBackendConfig {
+    maxTokens?: number;
+    /** Injected registry (used by tests and by a pi embedding). */
+    modelRegistry?: PiRegistryLike;
+}
+/** Structural view of pi's runtime used for setup/catalog/auth operations. */
+export interface PiRuntimeLike {
+    getProviders(): Array<{
+        id: string;
+        name?: string;
+        auth?: {
+            apiKey?: unknown;
+            oauth?: {
+                isSubscription?: boolean;
+            };
+        };
+    }>;
+    getProvider(providerId: string): {
+        id: string;
+        name?: string;
+        auth?: {
+            apiKey?: unknown;
+            oauth?: {
+                isSubscription?: boolean;
+            };
+        };
+    } | undefined;
+    getModels(providerId?: string): PiModelLike[];
+    hasConfiguredAuth(providerId: string): boolean;
+    getProviderAuthStatus(providerId: string): {
+        configured: boolean;
+        label?: string;
+        source?: string;
+    };
+    isUsingOAuth(providerId: string): boolean;
+    listCredentials(options?: unknown): Promise<Array<{
+        providerId: string;
+        type: string;
+    }>>;
+    login(providerId: string, type: string, interaction: unknown, options?: unknown): Promise<unknown>;
+    logout(providerId: string, options?: unknown): Promise<void>;
+    /** Image models whose provider has complete auth (ModelRuntime). */
+    getAvailableOfType?(type: string, providerId?: string): Promise<Array<unknown>>;
+    /** Runtime lookup of one image model. */
+    getModelOfType?(type: string, providerId: string, modelId: string): unknown;
+    /** Generate images with a resolved pi image model. */
+    generateImages?(model: unknown, context: unknown, options?: unknown): Promise<{
+        output?: Array<{
+            type: string;
+            data?: string;
+            mimeType?: string;
+            text?: string;
+        }>;
+        errorMessage?: string;
+    }>;
+}
+export interface PiProviderInfo {
+    id: string;
+    name: string;
+    apiKey: boolean;
+    oauth: boolean;
+    configured: boolean;
+    source?: string;
+    label?: string;
+}
+export interface PiModelInfo {
+    provider: string;
+    id: string;
+    name: string;
+    reasoning: boolean;
+    contextWindow?: number;
+    maxTokens?: number;
+    /** Thinking levels the model accepts (empty/undefined for non-reasoning). */
+    supportedThinkingLevels?: ThinkingLevel[];
+}
+/** Build the catalog `PiModelInfo` (with reasoning levels) from a raw model. */
+export declare function toPiModelInfo(model: PiModelLike & {
+    name?: string;
+}): PiModelInfo;
+export interface PiAuthPromptLike {
+    signal?: AbortSignal;
+    type: 'text' | 'secret' | 'select' | 'manual_code';
+    message: string;
+    placeholder?: string;
+    options?: ReadonlyArray<{
+        id: string;
+        label: string;
+        description?: string;
+    }>;
+}
+export interface PiAuthEventLike {
+    type: 'info' | 'auth_url' | 'device_code' | 'progress';
+    message?: string;
+    url?: string;
+    instructions?: string;
+    userCode?: string;
+    verificationUri?: string;
+    links?: ReadonlyArray<{
+        url: string;
+        label?: string;
+    }>;
+}
+export interface PiAuthInteractionLike {
+    signal?: AbortSignal;
+    prompt(prompt: PiAuthPromptLike): Promise<string>;
+    notify(event: PiAuthEventLike): void;
+}
+/** List providers from a pi runtime with auth capability/status. */
+export declare function listPiProviders(runtime: PiRuntimeLike): PiProviderInfo[];
+/** List chat models from a pi runtime, optionally filtered by provider. */
+export declare function listPiModels(runtime: PiRuntimeLike, providerId?: string): PiModelInfo[];
+/** A pi runtime handle: the model registry plus catalog/auth operations. */
+export interface PiRuntimeHandle {
+    registry: PiRegistryLike;
+    runtime: PiRuntimeLike;
+    listProviders(): PiProviderInfo[];
+    listModels(providerId?: string): PiModelInfo[];
+    hasAuth(providerId: string): boolean;
+    isUsingOAuth(providerId: string): boolean;
+    listCredentials(): Promise<Array<{
+        providerId: string;
+        type: string;
+    }>>;
+    login(providerId: string, interaction: PiAuthInteractionLike, type?: 'api_key' | 'oauth'): Promise<void>;
+    logout(providerId: string): Promise<void>;
+}
+/** Whether the pi dependency resolves (it is a required dependency of the SDK). */
+export declare function isPiPackageAvailable(): boolean;
+/**
+ * Open a pi runtime using an existing install's credential store and model
+ * catalog. This is the setup entry point used by `set-backend pi`; it does not
+ * require the pi CLI or a pre-existing pi session.
+ */
+export declare function openPiRuntime(options?: CreatePiBackendOptions): Promise<PiRuntimeHandle>;
+/** Resolved pi backend plus the model capabilities the UI/config needs. */
+export interface PiBackendInfo {
+    backend: LLMBackend;
+    /** The pi registry, for resolving `with_model/2` scopes. */
+    registry: PiRegistryLike;
+    modelId: string;
+    provider: string;
+    contextWindow?: number;
+    maxTokens: number;
+    reasoning: boolean;
+    thinkingLevel?: ThinkingLevel;
+    supportedThinkingLevels: ThinkingLevel[];
+    /** Set when a requested thinking level was unsupported and dropped. */
+    warning?: string;
+}
+/**
+ * Build an `LLMBackend` from pi's credential store. Throws a clear error when
+ * the pi packages are not installed.
+ */
+export declare function createPiBackend(options?: CreatePiBackendOptions): Promise<PiBackendInfo>;
+export interface ResolveBackendOptions {
+    kind?: BackendKind;
+    model?: string;
+    provider?: string;
+    maxTokens?: number;
+    agentDir?: string;
+    modelsPath?: string | null;
+    authPath?: string | null;
+    thinkingLevel?: string;
+}
+export interface ResolvedBackend {
+    kind: BackendKind;
+    /** Injected backend for pi; undefined for env (the runner builds it). */
+    llmBackend?: LLMBackend;
+    provider: string;
+    /** Bare model id. */
+    model: string;
+    /** `provider/model` (pi) or bare id (env), for display/persistence. */
+    modelId: string;
+    /** pi model capabilities (undefined for env). */
+    contextWindow?: number;
+    reasoning?: boolean;
+    thinkingLevel?: ThinkingLevel;
+    /** pi registry, for resolving `with_model/2` (pi backend only). */
+    registry?: PiRegistryLike;
+}
+/**
+ * Resolve the shared pi/env model backend used by both `deepclause run` and the
+ * REPL. `pi` (the default) returns an injected `LLMBackend`; `env` returns the
+ * provider/model so the runner builds the SDK provider backend.
+ */
+export declare function resolveLlmBackend(options?: ResolveBackendOptions): Promise<ResolvedBackend>;
+//# sourceMappingURL=backend.d.ts.map

package/dist/repl/backend.d.ts.map

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