@letta-ai/letta-code 0.30.2 → 0.30.3

package/dist/types/backend/dev/headless-turn-executor.d.ts

@@ -0,0 +1,28 @@
+import type { Stream } from "@letta-ai/letta-client/core/streaming";
+import type { LettaStreamingResponse } from "@letta-ai/letta-client/resources/agents/messages";
+import type { ConversationMessageCreateBody, ConversationMessageStreamBody } from "../backend";
+import type { LocalMessage } from "../local/local-message";
+import type { LocalAgentRecord, StoredMessage } from "../local/local-store";
+export type HeadlessTurnBody = ConversationMessageCreateBody | ConversationMessageStreamBody;
+export interface HeadlessTurnExecutorInput {
+    conversationId: string;
+    agentId: string;
+    agent: LocalAgentRecord;
+    systemPrompt?: string;
+    midConversationSystemPrompt?: string;
+    body: HeadlessTurnBody;
+    history: StoredMessage[];
+    uiMessages: LocalMessage[];
+}
+export interface HeadlessTurnExecutor {
+    execute(input: HeadlessTurnExecutorInput): Promise<Stream<LettaStreamingResponse>>;
+}
+export declare function createAssistantMessageStream(message?: Partial<Pick<StoredMessage, "id" | "date" | "content">>): Stream<LettaStreamingResponse>;
+export declare class DeterministicPongExecutor implements HeadlessTurnExecutor {
+    execute(_input: HeadlessTurnExecutorInput): Promise<Stream<LettaStreamingResponse>>;
+}
+export declare class DeterministicToolCallExecutor implements HeadlessTurnExecutor {
+    private toolCallSeq;
+    execute(input: HeadlessTurnExecutorInput): Promise<Stream<LettaStreamingResponse>>;
+}
+//# sourceMappingURL=headless-turn-executor.d.ts.map

package/dist/types/backend/dev/headless-turn-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-turn-executor.d.ts","sourceRoot":"","sources":["../../../../src/backend/dev/headless-turn-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAC/F,OAAO,KAAK,EACV,6BAA6B,EAC7B,6BAA6B,EAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACd,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,gBAAgB,GACxB,6BAA6B,GAC7B,6BAA6B,CAAC;AAElC,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,gBAAgB,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,UAAU,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CACL,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC;CAC5C;AAgBD,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC,CAAM,GACpE,MAAM,CAAC,sBAAsB,CAAC,CAahC;AA+BD,qBAAa,yBAA0B,YAAW,oBAAoB;IAC9D,OAAO,CAAC,MAAM,EAAE,yBAAyB;CAGhD;AAED,qBAAa,6BAA8B,YAAW,oBAAoB;IACxE,OAAO,CAAC,WAAW,CAAK;IAElB,OAAO,CAAC,KAAK,EAAE,yBAAyB;CA2B/C"}

package/dist/types/backend/dev/local-provider-errors.d.ts

@@ -0,0 +1,13 @@
+export interface LocalProviderErrorInfo {
+    message: string;
+    detail: string;
+    error_type: "llm_error" | "local_backend_error";
+    retryable: boolean;
+    stop_reason: "llm_api_error" | "error";
+}
+export declare function localProviderErrorDetail(error: unknown): string;
+export declare function isRetryableLocalProviderError(error: unknown): boolean;
+export declare function normalizeLocalProviderError(error: unknown): LocalProviderErrorInfo;
+export declare function localProviderRetryDelayMs(error: unknown, attempt: number): number;
+export declare function localProviderRetryMessage(error: unknown): string;
+//# sourceMappingURL=local-provider-errors.d.ts.map

package/dist/types/backend/dev/local-provider-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-provider-errors.d.ts","sourceRoot":"","sources":["../../../../src/backend/dev/local-provider-errors.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,GAAG,qBAAqB,CAAC;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC;CACxC;AA+DD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAsB/D;AA8DD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAYrE;AAiBD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,GACb,sBAAsB,CAYxB;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,GACd,MAAM,CAkBR;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGhE"}

package/dist/types/backend/dev/pi-api-streams.d.ts

@@ -0,0 +1,10 @@
+import type { KnownApi, ProviderStreams } from "@earendil-works/pi-ai";
+/**
+ * ProviderStreams implementations for every pi-ai API, keyed by `model.api`.
+ * Used by providers whose models may span multiple APIs (mod-registered
+ * providers) and by dispatch-only providers for models whose owner has not
+ * yet been migrated onto the Models runtime. All implementations are lazy —
+ * the underlying API module loads on first stream.
+ */
+export declare function knownApiStreams(): Partial<Record<KnownApi, ProviderStreams>>;
+//# sourceMappingURL=pi-api-streams.d.ts.map

package/dist/types/backend/dev/pi-api-streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-api-streams.d.ts","sourceRoot":"","sources":["../../../../src/backend/dev/pi-api-streams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAWvE;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAY5E"}

package/dist/types/backend/dev/pi-image-elision.d.ts

@@ -0,0 +1,15 @@
+import type { ProviderTurnInput } from "./provider-turn-executor";
+export declare function isOversizedPayloadTransportFailure(input: ProviderTurnInput): boolean;
+export interface ImagePayloadElision {
+    input: ProviderTurnInput;
+    beforeBytes: number;
+    afterBytes: number;
+    requestByteLimit: number;
+    requestByteTarget: number;
+    elidedImages: number;
+    elidedBytes: number;
+}
+export declare function elideImagePayloadsForProviderRetry(input: ProviderTurnInput, options?: {
+    allowUnderLimit?: boolean;
+}): ImagePayloadElision | null;
+//# sourceMappingURL=pi-image-elision.d.ts.map

package/dist/types/backend/dev/pi-image-elision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-image-elision.d.ts","sourceRoot":"","sources":["../../../../src/backend/dev/pi-image-elision.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AA8ClE,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAIT;AASD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,iBAAiB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAkED,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,mBAAmB,GAAG,IAAI,CA0C5B"}

package/dist/types/backend/dev/pi-llama-cpp-provider.d.ts

@@ -0,0 +1,18 @@
+import type { Provider } from "@earendil-works/pi-ai";
+export declare const LLAMA_CPP_PI_PROVIDER_ID = "llama-cpp";
+export interface LlamaCppPiProviderOptions {
+    /** Base URL as configured; `/v1` is appended/stripped as needed. */
+    baseURL: string;
+    apiKey?: string;
+    fetchImpl?: typeof fetch;
+    discoveryTimeoutMs?: number;
+}
+/**
+ * Real dynamic pi-ai Provider for a llama.cpp server. Replaces the Letta
+ * connector that fabricated Models from name substrings; mirrors upstream
+ * Pi's first-class llama.cpp provider design (per-model engine metadata
+ * owns capabilities). See `createLocalEndpointPiProvider` for shared
+ * refresh/auth semantics.
+ */
+export declare function createLlamaCppPiProvider(options: LlamaCppPiProviderOptions): Provider<"openai-completions">;
+//# sourceMappingURL=pi-llama-cpp-provider.d.ts.map

package/dist/types/backend/dev/pi-llama-cpp-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-llama-cpp-provider.d.ts","sourceRoot":"","sources":["../../../../src/backend/dev/pi-llama-cpp-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAStD,eAAO,MAAM,wBAAwB,cAAc,CAAC;AAEpD,MAAM,WAAW,yBAAyB;IACxC,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAwMD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,QAAQ,CAAC,oBAAoB,CAAC,CAYhC"}

package/dist/types/backend/dev/pi-lmstudio-provider.d.ts

@@ -0,0 +1,16 @@
+import type { Provider } from "@earendil-works/pi-ai";
+export declare const LMSTUDIO_PI_PROVIDER_ID = "lmstudio";
+export interface LmStudioPiProviderOptions {
+    /** Base URL as configured; `/v1` is appended/stripped as needed. */
+    baseURL: string;
+    apiKey?: string;
+    fetchImpl?: typeof fetch;
+    discoveryTimeoutMs?: number;
+}
+/**
+ * Real dynamic pi-ai Provider for an LM Studio server, replacing the Letta
+ * connector that fabricated Models from name substrings. See
+ * `createLocalEndpointPiProvider` for shared refresh/auth semantics.
+ */
+export declare function createLmStudioPiProvider(options: LmStudioPiProviderOptions): Provider<"openai-completions">;
+//# sourceMappingURL=pi-lmstudio-provider.d.ts.map

package/dist/types/backend/dev/pi-lmstudio-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-lmstudio-provider.d.ts","sourceRoot":"","sources":["../../../../src/backend/dev/pi-lmstudio-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAQtD,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAElD,MAAM,WAAW,yBAAyB;IACxC,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAiFD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,QAAQ,CAAC,oBAAoB,CAAC,CAYhC"}

package/dist/types/backend/dev/pi-local-endpoint-provider.d.ts

@@ -0,0 +1,77 @@
+import type { Model, Provider } from "@earendil-works/pi-ai";
+export declare const LOCAL_ENDPOINT_DEFAULT_CONTEXT_WINDOW = 128000;
+export type LocalEndpointModel = Model<"openai-completions">;
+/**
+ * Engine metadata for one discovered model. `vision`/`thinking` left
+ * undefined mean the engine did not report the capability — the model is
+ * published conservatively (text-only, non-reasoning), never guessed from
+ * the model name.
+ */
+export interface LocalEndpointModelMetadata {
+    id: string;
+    vision?: boolean;
+    thinking?: boolean;
+    /** Engine-reported available window; the shared builder applies its default cap. */
+    contextLength?: number;
+    /** Engine-specific output cap; defaults to the shared constant. */
+    maxTokens?: number;
+    /** Engine-specific OpenAI-compat overrides merged over the defaults. */
+    compat?: Model<"openai-completions">["compat"];
+}
+export interface LocalEndpointDiscoveryContext {
+    /** GET (or POST when `body` is set) returning parsed JSON; throws on !ok. */
+    fetchJson(url: string, init?: {
+        body?: unknown;
+    }): Promise<unknown>;
+    /** Engine-native base URL (no trailing `/v1`). */
+    nativeBaseURL: string;
+    /** OpenAI-compatible base URL (with `/v1`), used for turn requests. */
+    openAIBaseURL: string;
+    /**
+     * Models from the last successful refresh, read from the pi-ai
+     * ModelsStore — the single source of last-known retention.
+     */
+    lastKnown: ReadonlyMap<string, LocalEndpointModel>;
+    /**
+     * Engine metadata fingerprints (e.g. Ollama tag digests) from the
+     * previous refresh, keyed by model id. Provider-instance-scoped: a
+     * connection change rebuilds the provider and discards them. Engines use
+     * this to skip expensive per-model metadata fetches when the installed
+     * artifact is unchanged; it never stores Model/capability data.
+     */
+    metadataFingerprints: ReadonlyMap<string, string>;
+    /** Fingerprints to persist for the next refresh; engines fill this in. */
+    nextMetadataFingerprints: Map<string, string>;
+    /** Builds the complete pi-ai Model from engine metadata. */
+    buildModel(metadata: LocalEndpointModelMetadata): LocalEndpointModel;
+}
+export type LocalEndpointDiscover = (context: LocalEndpointDiscoveryContext) => Promise<LocalEndpointModel[]>;
+export interface LocalEndpointPiProviderOptions {
+    id: string;
+    name: string;
+    /** Base URL as configured; `/v1` is appended/stripped as needed. */
+    baseURL: string;
+    apiKey?: string;
+    fetchImpl?: typeof fetch;
+    discoveryTimeoutMs?: number;
+    discover: LocalEndpointDiscover;
+}
+/** Strips a trailing `/v1` to reach the engine-native API surface. */
+export declare function localEndpointNativeBaseURL(baseURL: string): string;
+export declare function localEndpointOpenAIBaseURL(baseURL: string): string;
+export declare function modelIdsFromOpenAICompatibleList(data: unknown): string[];
+/**
+ * Real dynamic pi-ai Provider for an OpenAI-compatible local engine. The
+ * provider owns keyless/keyed auth, model discovery, complete Model
+ * construction from authoritative engine metadata, and stream dispatch; the
+ * same Model instance serves /model listing and turn execution.
+ *
+ * Only the `discover` callback is engine-specific: each engine exposes its
+ * capability metadata on a different native API (Ollama `POST /api/show`,
+ * llama.cpp `GET /props`, LM Studio `GET /api/v0/models`), so discovery is
+ * a per-engine translation into `LocalEndpointModelMetadata`. Everything
+ * else — timeout/auth handling, last-known retention on refresh failure,
+ * provider wiring — is shared here.
+ */
+export declare function createLocalEndpointPiProvider(options: LocalEndpointPiProviderOptions): Provider<"openai-completions">;
+//# sourceMappingURL=pi-local-endpoint-provider.d.ts.map

package/dist/types/backend/dev/pi-local-endpoint-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-local-endpoint-provider.d.ts","sourceRoot":"","sources":["../../../../src/backend/dev/pi-local-endpoint-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,QAAQ,EAET,MAAM,uBAAuB,CAAC;AAI/B,eAAO,MAAM,qCAAqC,SAAS,CAAC;AAI5D,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,oBAAoB,CAAC,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,6BAA6B;IAC5C,6EAA6E;IAC7E,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpE,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACnD;;;;;;OAMG;IACH,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,0EAA0E;IAC1E,wBAAwB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,4DAA4D;IAC5D,UAAU,CAAC,QAAQ,EAAE,0BAA0B,GAAG,kBAAkB,CAAC;CACtE;AAED,MAAM,MAAM,qBAAqB,GAAG,CAClC,OAAO,EAAE,6BAA6B,KACnC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEnC,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAED,sEAAsE;AACtE,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAWxE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,QAAQ,CAAC,oBAAoB,CAAC,CA2HhC"}

package/dist/types/backend/dev/pi-mod-provider.d.ts

@@ -0,0 +1,30 @@
+import type { Api, Model, Provider } from "@earendil-works/pi-ai";
+import type { PiProviderModelRegistration, PiProviderRegistration, RegisteredPiProvider } from "./pi-provider-mod-registry";
+/**
+ * Maps a mod's model registration to the complete pi-ai Model the provider
+ * publishes. Connection-derived auth headers are intentionally not baked in:
+ * they are per-request state resolved by pi-model-factory and passed as
+ * stream options, which pi-ai merges over provider defaults.
+ */
+export declare function registrationModelToPiModel(input: {
+    providerName: string;
+    config: PiProviderRegistration;
+    model: PiProviderModelRegistration;
+    baseURL?: string;
+    headers?: Record<string, string>;
+}): Model<Api>;
+export interface ModPiProviderOptions {
+    registered: RegisteredPiProvider;
+    storageDir?: string;
+}
+/**
+ * Real pi-ai Provider for a mod-registered provider (LET-10130). The
+ * declarative mod registration stays the mod-facing vocabulary; this adapter
+ * turns it into the concrete runtime unit: statically declared models are
+ * published as complete pi-ai Models, a mod `listModels` hook becomes the
+ * provider's dynamic `refreshModels` (with last-known retention on failure,
+ * seeded from the static declaration), and stream dispatch runs through the
+ * provider's per-API implementations.
+ */
+export declare function createModPiProvider(options: ModPiProviderOptions): Provider;
+//# sourceMappingURL=pi-mod-provider.d.ts.map

package/dist/types/backend/dev/pi-mod-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-mod-provider.d.ts","sourceRoot":"","sources":["../../../../src/backend/dev/pi-mod-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,GAAG,EACH,KAAK,EACL,QAAQ,EAET,MAAM,uBAAuB,CAAC;AAI/B,OAAO,KAAK,EACV,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AAQpC;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,KAAK,EAAE,2BAA2B,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GAAG,KAAK,CAAC,GAAG,CAAC,CA4Bb;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,oBAAoB,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,QAAQ,CAsF3E"}

package/dist/types/backend/dev/pi-model-factory.d.ts

@@ -0,0 +1,53 @@
+import type { Api, Model, ThinkingLevel } from "@earendil-works/pi-ai";
+import { type LocalProviderTimeout } from "../local/local-provider-timeout";
+import { LocalPiModelsRuntime } from "./pi-models-runtime";
+import { type PiProvider } from "./pi-provider-registry";
+export declare const DEFAULT_PI_PROVIDER = "openai";
+export declare const UNSELECTED_LOCAL_MODEL_HANDLE = "local/default";
+export type { PiProvider } from "./pi-provider-registry";
+export declare function isUnselectedLocalModelHandle(model: unknown): boolean;
+export declare function reasoningForSettings(modelSettings: Record<string, unknown>, modelHandle?: string): ThinkingLevel | undefined;
+export interface PiModelSettings {
+    provider_type?: unknown;
+    context_window_limit?: unknown;
+    max_tokens?: unknown;
+    service_tier?: unknown;
+}
+export interface PiModelFactoryOptions {
+    provider?: string;
+    model?: string;
+    localProviderAuthStorageDir?: string;
+    preferredProviderType?: string;
+    /**
+     * Per-backend pi-ai Models runtime. Runtime-managed providers (local
+     * endpoints and mod registrations) resolve to the complete Model object
+     * published by the provider that discovered it; a call-scoped runtime is
+     * created when omitted. Models are never fabricated from name strings.
+     */
+    modelsRuntime?: LocalPiModelsRuntime;
+}
+export interface ResolvedPiModel {
+    provider: PiProvider;
+    model: Model<Api>;
+    apiKey?: string;
+    timeout: LocalProviderTimeout;
+    headers?: Record<string, string>;
+    providerOptions?: Record<string, unknown>;
+    envOverrides?: Record<string, string | undefined>;
+}
+export declare function applyPiEnvOverrides(overrides: Record<string, string | undefined> | undefined): () => void;
+export declare function resolvePiProvider(provider?: string): PiProvider;
+export declare function resolvePiProviderFromAgent(model: string | undefined, modelSettings?: PiModelSettings): PiProvider;
+export declare function resolvePiModelFromAgent(model: string | undefined, provider: PiProvider): string | undefined;
+export interface ZaiConnection {
+    apiKey?: string;
+    baseURL: string;
+    providerName: "zai" | "zai-coding";
+    timeout: LocalProviderTimeout;
+}
+export declare function resolveZaiConnection(options: {
+    storageDir?: string;
+    preferredProviderType?: "zai" | "zai_coding";
+}): ZaiConnection;
+export declare function resolvePiModelForAgent(modelHandle: string | undefined, modelSettings?: PiModelSettings, options?: PiModelFactoryOptions): Promise<ResolvedPiModel>;
+//# sourceMappingURL=pi-model-factory.d.ts.map

package/dist/types/backend/dev/pi-model-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-model-factory.d.ts","sourceRoot":"","sources":["../../../../src/backend/dev/pi-model-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAQvE,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAM3D,OAAO,EAML,KAAK,UAAU,EAIhB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,mBAAmB,WAAgC,CAAC;AACjE,eAAO,MAAM,6BAA6B,kBAAkB,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQpE;AAuCD,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,GAAG,SAAS,CAe3B;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACnD;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,GACxD,MAAM,IAAI,CAoBZ;AAcD,wBAAgB,iBAAiB,CAC/B,QAAQ,SACgC,GACvC,UAAU,CAMZ;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,aAAa,GAAE,eAAoB,GAClC,UAAU,CAwBZ;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,UAAU,GACnB,MAAM,GAAG,SAAS,CAEpB;AAiCD,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,KAAK,GAAG,YAAY,CAAC;IACnC,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,KAAK,GAAG,YAAY,CAAC;CAC9C,GAAG,aAAa,CAkDhB;AA6FD,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,aAAa,GAAE,eAAoB,EACnC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,eAAe,CAAC,CA8K1B"}

package/dist/types/backend/dev/pi-models-runtime.d.ts

@@ -0,0 +1,120 @@
+import type { Api, AssistantMessageEventStream, AuthResult, Context, Credential, Model, ModelsApiStreamOptions, ModelsSimpleStreamOptions } from "@earendil-works/pi-ai";
+export interface LocalPiModelsRuntimeOptions {
+    storageDir?: string;
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Per-local-backend pi-ai Models runtime: the source of truth for provider
+ * registration, model lookup, refresh, and stream dispatch in the local turn
+ * path (LET-10126). One instance per LocalBackend — never module-global — so
+ * concurrent agents with different storage dirs cannot share mutable provider
+ * state.
+ *
+ * Built-in pi-ai providers are registered as-is. Local endpoint providers
+ * that own dynamic discovery (Ollama LET-10127, Ollama Cloud, llama.cpp
+ * LET-10128, LM Studio LET-10129) are rebuilt when their Letta-side
+ * connection record (base URL/auth) changes; a change invalidates and
+ * refreshes only that provider.
+ */
+export declare class LocalPiModelsRuntime {
+    private readonly models;
+    private readonly storageDir?;
+    private readonly fetchImpl?;
+    private readonly endpointSignatures;
+    private readonly modSignatures;
+    private readonly modelsStore;
+    private readonly credentials;
+    private readonly dynamicBuiltinIds;
+    private readonly credentialSignatures;
+    constructor(options?: LocalPiModelsRuntimeOptions);
+    /**
+     * Provider ids whose published catalog can vary with the stored account:
+     * dynamic built-ins (e.g. Radius) plus mod providers with a `listModels`
+     * hook. A mod registration owns its id either way — a static mod catalog
+     * overriding a dynamic built-in id is not account-scoped.
+     */
+    private accountScopedProviderIds;
+    /**
+     * Account-scoped catalogs are invalidated when the stored credential's
+     * identity changes: drop the persisted catalog and rebuild the provider so
+     * one account's models cannot be listed — or resolved for a turn — while
+     * requests authenticate as another. This covers OAuth account switches on
+     * dynamic mods too, whose reconstruction signature (revision/base URL/API
+     * key) cannot see OAuth credentials. Routine access-token refreshes keep
+     * the identity (volatile `access`/`expires` fields are excluded), so they
+     * do not clear last-known retention.
+     */
+    private invalidateOnCredentialChange;
+    /**
+     * Resolve request auth for a provider through the runtime: stored
+     * credential (via the auth.json adapter, refreshing OAuth as needed) or
+     * the provider's ambient sources.
+     */
+    getAuth(providerId: string): Promise<AuthResult | undefined>;
+    /**
+     * One consistent turn resolution: credential-identity invalidation, auth,
+     * and model lookup happen against the same provider state, so a
+     * credential change can never pair the new account's auth with a stale
+     * account's cached model. On a model miss, dynamic catalogs refresh once.
+     *
+     * Account writes (logins) are not serialized against resolution, and
+     * `Models.getAuth` performs its own credential read — so after resolving,
+     * verify the stored identity is still the one the invalidation snapshot
+     * validated the catalog against. If it moved mid-flight, invalidate and
+     * retry with the new identity; if it is still moving when the retry
+     * budget is exhausted, fail closed (throw) rather than return a pair
+     * whose auth and catalog may come from different accounts.
+     */
+    resolveTurn(providerId: string, modelId: string, fallbackModelId?: string): Promise<{
+        model: Model<Api> | undefined;
+        auth: AuthResult | undefined;
+    }>;
+    /**
+     * Detects an account switch that landed between the invalidation snapshot
+     * and auth/catalog resolution. Only account-scoped providers have a
+     * recorded identity to compare against — other catalogs do not vary by
+     * account, so a mid-flight credential change cannot mismatch them.
+     */
+    private credentialIdentityMovedSinceInvalidation;
+    /** Stored (possibly just-refreshed) credential for a provider. */
+    getStoredCredential(providerId: string): Promise<Credential | undefined>;
+    /** Providers whose models this runtime discovers and owns end-to-end. */
+    isRuntimeManagedProvider(providerId: string): boolean;
+    /**
+     * Registers/refreshes the pi-ai Provider for a mod registration. Returns
+     * true when the provider id is (or was) mod-owned — mod registrations take
+     * precedence over the built-in endpoint table, matching pi-model-factory's
+     * resolution order. The per-name registry revision detects re-registration
+     * so only the affected provider is rebuilt.
+     */
+    private ensureModProvider;
+    private ensureEndpointProvider;
+    private ensureManagedProviders;
+    getModels(providerId?: string): readonly Model<Api>[];
+    getModel(providerId: string, modelId: string): Model<Api> | undefined;
+    /**
+     * Canonical catalog refresh: pi-ai's Models.refresh resolves each dynamic
+     * provider's effective credential (refreshing OAuth under the store lock),
+     * supplies its store-backed RefreshModelsContext, and skips unconfigured
+     * providers — so unconfigured remote endpoints and mod listModels hooks
+     * are never probed, while keyless local daemons ("not-needed") and
+     * credentialed dynamic built-ins (e.g. radius) refresh correctly.
+     * Per-provider fetch failures keep that provider's last-known list.
+     */
+    refreshAll(): Promise<void>;
+    /**
+     * Refresh with per-provider error semantics: rejects with the given
+     * provider's fetch error while the provider keeps serving its last-known
+     * list.
+     */
+    refresh(providerId: string): Promise<void>;
+    /**
+     * Runtime model lookup for turn execution: last-known list first, then one
+     * refresh attempt for dynamic providers when the model is absent. Returns
+     * the same Model instance that listing published.
+     */
+    resolveModel(providerId: string, modelId: string): Promise<Model<Api> | undefined>;
+    stream<TApi extends Api>(model: Model<TApi>, context: Context, options?: ModelsApiStreamOptions<TApi>): AssistantMessageEventStream;
+    streamSimple(model: Model<Api>, context: Context, options?: ModelsSimpleStreamOptions): AssistantMessageEventStream;
+}
+//# sourceMappingURL=pi-models-runtime.d.ts.map

package/dist/types/backend/dev/pi-models-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-models-runtime.d.ts","sourceRoot":"","sources":["../../../../src/backend/dev/pi-models-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,GAAG,EACH,2BAA2B,EAC3B,UAAU,EACV,OAAO,EACP,UAAU,EAEV,KAAK,EACL,sBAAsB,EACtB,yBAAyB,EAG1B,MAAM,uBAAuB,CAAC;AAkE/B,MAAM,WAAW,2BAA2B;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAmFD;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;IAChE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAsB;IACxD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6B;gBAEtD,OAAO,GAAE,2BAAgC;IAuBrD;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAShC;;;;;;;;;OASG;YACW,4BAA4B;IA0B1C;;;;OAIG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAMlE;;;;;;;;;;;;;OAaG;IACG,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;QAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAA;KAAE,CAAC;IAgC3E;;;;;OAKG;YACW,wCAAwC;IAStD,kEAAkE;IAC5D,mBAAmB,CACvB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIlC,yEAAyE;IACzE,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAOrD;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IA4CzB,OAAO,CAAC,sBAAsB;IAkC9B,OAAO,CAAC,sBAAsB;IAkB9B,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE;IAKrD,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS;IAKrE;;;;;;;;OAQG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;;OAIG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhD;;;;OAIG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAYlC,MAAM,CAAC,IAAI,SAAS,GAAG,EACrB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,sBAAsB,CAAC,IAAI,CAAC,GACrC,2BAA2B;IAK9B,YAAY,CACV,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,yBAAyB,GAClC,2BAA2B;CAI/B"}

package/dist/types/backend/dev/pi-oauth.d.ts

@@ -0,0 +1,17 @@
+import type { OAuthAuth } from "@earendil-works/pi-ai";
+import { type PiProviderOAuthConfig } from "./pi-provider-mod-registry";
+/** Adapts a mod's declarative OAuth config onto pi-ai's OAuthAuth. */
+export declare function modOAuthAuth(providerName: string, config: PiProviderOAuthConfig, registration?: {
+    authHeader?: boolean;
+}): OAuthAuth;
+/**
+ * OAuth implementation for a provider id: mod registration first (matching
+ * the resolution order everywhere else), then built-in pi-ai providers.
+ */
+export declare function getProviderOAuthAuth(providerId: string): OAuthAuth | undefined;
+/** Built-in providers that support subscription (OAuth) login. */
+export declare function listBuiltinOAuthProviders(): Array<{
+    id: string;
+    name: string;
+}>;
+//# sourceMappingURL=pi-oauth.d.ts.map

package/dist/types/backend/dev/pi-oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-oauth.d.ts","sourceRoot":"","sources":["../../../../src/backend/dev/pi-oauth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOxE,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,4BAA4B,CAAC;AAsDpC,sEAAsE;AACtE,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,qBAAqB,EAC7B,YAAY,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GACtC,SAAS,CAqBX;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,GACjB,SAAS,GAAG,SAAS,CAUvB;AAED,kEAAkE;AAClE,wBAAgB,yBAAyB,IAAI,KAAK,CAAC;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAKD"}

package/dist/types/backend/dev/pi-ollama-provider.d.ts

@@ -0,0 +1,20 @@
+import type { Provider } from "@earendil-works/pi-ai";
+export declare const OLLAMA_PI_PROVIDER_ID = "ollama";
+export declare const OLLAMA_CLOUD_PI_PROVIDER_ID = "ollama-cloud";
+export interface OllamaPiProviderOptions {
+    /** Base URL as configured; `/v1` is appended/stripped as needed. */
+    baseURL: string;
+    apiKey?: string;
+    fetchImpl?: typeof fetch;
+    discoveryTimeoutMs?: number;
+    /** Defaults to the local Ollama provider; Ollama Cloud reuses this factory. */
+    providerId?: string;
+    name?: string;
+}
+/**
+ * Real dynamic pi-ai Provider for an Ollama endpoint (local daemon or
+ * Ollama Cloud — both speak the same native API). See
+ * `createLocalEndpointPiProvider` for the shared refresh/auth semantics.
+ */
+export declare function createOllamaPiProvider(options: OllamaPiProviderOptions): Provider<"openai-completions">;
+//# sourceMappingURL=pi-ollama-provider.d.ts.map

package/dist/types/backend/dev/pi-ollama-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-ollama-provider.d.ts","sourceRoot":"","sources":["../../../../src/backend/dev/pi-ollama-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAOtD,eAAO,MAAM,qBAAqB,WAAW,CAAC;AAC9C,eAAO,MAAM,2BAA2B,iBAAiB,CAAC;AAE1D,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA0GD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,QAAQ,CAAC,oBAAoB,CAAC,CAehC"}

package/dist/types/backend/dev/pi-provider-mod-registry.d.ts

@@ -0,0 +1,25 @@
+import type { PiProviderRegistration, RegisteredPiProvider } from "./pi-provider-mod-types";
+export type { PiProviderConnectConfig, PiProviderConnectField, PiProviderConnection, PiProviderInputType, PiProviderModelRegistration, PiProviderOAuthConfig, PiProviderOAuthDeviceCodeInfo, PiProviderOAuthLoginCallbacks, PiProviderRegistration, RegisteredPiProvider, } from "./pi-provider-mod-types";
+type PiProviderRegistryListener = () => void;
+export declare function getPiProviderRegistryRevision(): number;
+/**
+ * Monotonic per-provider registration revision. Bumps on every register or
+ * unregister of that provider name, letting per-backend Models runtimes
+ * detect that a registration changed and rebuild only that provider.
+ */
+export declare function getRegisteredPiProviderRevision(providerName: string): number;
+export declare function subscribePiProviderRegistry(listener: PiProviderRegistryListener): () => void;
+export declare function registerPiProvider(providerName: string, config: PiProviderRegistration, owner?: {
+    id?: string;
+    path?: string;
+}): RegisteredPiProvider;
+export declare function unregisterPiProvider(providerName: string, ownerId?: string): void;
+export declare function unregisterPiProvidersForOwner(ownerId: string): void;
+export declare function clearRegisteredPiProviders(): void;
+export declare function getRegisteredPiProvider(providerName: string): RegisteredPiProvider | undefined;
+export declare function listRegisteredPiProviders(): RegisteredPiProvider[];
+export declare function resolveRegisteredPiProviderFromModelHandle(model: string | undefined): string | undefined;
+export declare function stripRegisteredProviderHandlePrefix(model: string | undefined, providerName: string): string | undefined;
+export declare function resolveRegisteredPiProviderApiKey(apiKey: string | undefined): string | undefined;
+export declare function resolveRegisteredPiProviderHeaders(headers: PiProviderRegistration["headers"]): Record<string, string> | undefined;
+//# sourceMappingURL=pi-provider-mod-registry.d.ts.map

package/dist/types/backend/dev/pi-provider-mod-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-provider-mod-registry.d.ts","sourceRoot":"","sources":["../../../../src/backend/dev/pi-provider-mod-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AAOjC,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,EACrB,6BAA6B,EAC7B,6BAA6B,EAC7B,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAEjC,KAAK,0BAA0B,GAAG,MAAM,IAAI,CAAC;AAO7C,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAOD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE5E;AAaD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,0BAA0B,GACnC,MAAM,IAAI,CAKZ;AAED,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,sBAAsB,EAC9B,KAAK,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACrC,oBAAoB,CAYtB;AAED,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAON;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAUnE;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAOjD;AAED,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,GACnB,oBAAoB,GAAG,SAAS,CAOlC;AAED,wBAAgB,yBAAyB,IAAI,oBAAoB,EAAE,CAKlE;AAED,wBAAgB,0CAA0C,CACxD,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,GAAG,SAAS,CAKpB;AAED,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,YAAY,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,sBAAsB,CAAC,SAAS,CAAC,GACzC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAEpC"}

package/dist/types/backend/dev/pi-provider-mod-types.d.ts

@@ -0,0 +1,66 @@
+import type { Api, Model } from "@earendil-works/pi-ai";
+import type { OAuthCredentials, OAuthLoginCallbacks } from "@earendil-works/pi-ai/oauth";
+export type PiProviderInputType = "text" | "image";
+/**
+ * A mod's model declaration, derived directly from pi-ai's Model type
+ * (LET-10130): the provider is implied by the registration, and `api`/
+ * `baseUrl` may be inherited from the provider-level config, so those
+ * fields are relaxed. Everything else — capability inputs, cost, context
+ * window, compat overrides — is pi-ai's own vocabulary.
+ */
+export type PiProviderModelRegistration = Omit<Model<Api>, "api" | "provider" | "baseUrl"> & {
+    api?: Api;
+    baseUrl?: string;
+};
+export interface PiProviderConnection {
+    id: string;
+    providerName: string;
+    baseUrl?: string;
+    apiKey?: string;
+    headers?: Record<string, string>;
+}
+export interface PiProviderConnectField {
+    key: string;
+    label: string;
+    placeholder?: string;
+    secret?: boolean;
+}
+export interface PiProviderConnectConfig {
+    fields?: PiProviderConnectField[];
+}
+export interface PiProviderOAuthDeviceCodeInfo {
+    verificationUri: string;
+    userCode: string;
+    intervalSeconds?: number;
+    expiresInSeconds?: number;
+}
+export interface PiProviderOAuthLoginCallbacks extends Omit<OAuthLoginCallbacks, "onDeviceCode"> {
+    onDeviceCode?: (info: PiProviderOAuthDeviceCodeInfo) => void;
+}
+export interface PiProviderOAuthConfig {
+    name?: string;
+    login: (callbacks: PiProviderOAuthLoginCallbacks) => Promise<OAuthCredentials>;
+    refreshToken: (credentials: OAuthCredentials) => Promise<OAuthCredentials>;
+    getApiKey: (credentials: OAuthCredentials) => string;
+    modifyModels?: (models: Model<Api>[], credentials: OAuthCredentials) => Model<Api>[];
+}
+export interface PiProviderRegistration {
+    name?: string;
+    description?: string;
+    baseUrl?: string;
+    apiKey?: string;
+    api?: Api;
+    headers?: Record<string, string>;
+    authHeader?: boolean;
+    models?: PiProviderModelRegistration[];
+    listModels?: (connection: PiProviderConnection) => Promise<PiProviderModelRegistration[]> | PiProviderModelRegistration[];
+    connect?: boolean | PiProviderConnectConfig;
+    oauth?: PiProviderOAuthConfig;
+}
+export interface RegisteredPiProvider {
+    providerName: string;
+    config: PiProviderRegistration;
+    ownerId?: string;
+    path?: string;
+}
+//# sourceMappingURL=pi-provider-mod-types.d.ts.map

package/dist/types/backend/dev/pi-provider-mod-types.d.ts.map

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

package/dist/types/backend/dev/pi-provider-mod-validation.d.ts

@@ -0,0 +1,5 @@
+import type { PiProviderRegistration } from "./pi-provider-mod-types";
+export declare function resolvePiProviderRegistrationHeaders(headers: Record<string, string> | undefined): Record<string, string> | undefined;
+export declare function clonePiProviderRegistration(config: PiProviderRegistration): PiProviderRegistration;
+export declare function validatePiProviderRegistration(providerName: string, config: PiProviderRegistration): void;
+//# sourceMappingURL=pi-provider-mod-validation.d.ts.map

package/dist/types/backend/dev/pi-provider-mod-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-provider-mod-validation.d.ts","sourceRoot":"","sources":["../../../../src/backend/dev/pi-provider-mod-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AAQjC,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAC1C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAOpC;AAiBD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,sBAAsB,GAC7B,sBAAsB,CAMxB;AA8JD,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,sBAAsB,GAC7B,IAAI,CAgCN"}