@moxxy/sdk 0.1.0

package/dist/permission.d.ts

@@ -0,0 +1,35 @@
+import type { ToolCallRequestedEvent } from './events.js';
+export type PermissionMode = 'allow' | 'allow_session' | 'allow_always' | 'deny';
+export interface PermissionDecision {
+    readonly mode: PermissionMode;
+    readonly reason?: string;
+}
+export interface PermissionRule {
+    readonly action: 'allow' | 'deny' | 'prompt';
+    readonly pattern?: {
+        name?: string | RegExp;
+        inputMatches?: Record<string, string | RegExp>;
+    };
+    readonly reason?: string;
+}
+export interface PendingToolCall {
+    readonly callId: ToolCallRequestedEvent['callId'];
+    readonly name: string;
+    readonly input: unknown;
+    /**
+     * Sequence number of the `tool_call_requested` event in the EventLog.
+     * Optional because permission resolvers may construct PendingToolCalls
+     * for evaluations that aren't yet on the log (e.g., hook rewrites).
+     */
+    readonly requestedAtSeq?: number;
+}
+export interface PermissionContext {
+    readonly toolDescription?: string;
+    readonly skillContext?: string;
+    readonly sessionId: string;
+}
+export interface PermissionResolver {
+    readonly name: string;
+    check(call: PendingToolCall, ctx: PermissionContext): Promise<PermissionDecision>;
+}
+//# sourceMappingURL=permission.d.ts.map

package/dist/permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.d.ts","sourceRoot":"","sources":["../src/permission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,eAAe,GAAG,cAAc,GAAG,MAAM,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;KAAE,CAAC;IAC9F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACnF"}

package/dist/permission.js

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

package/dist/permission.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,88 @@
+import type { AgentDef } from './agent.js';
+import type { CacheStrategyDef } from './cache-strategy.js';
+import type { ChannelDef } from './channel.js';
+import type { CommandDef } from './command.js';
+import type { CompactorDef } from './compactor.js';
+import type { LifecycleHooks } from './hooks.js';
+import type { ModeDef } from './mode.js';
+import type { ProviderDef } from './provider.js';
+import type { MoxxyRequirement } from './requirements.js';
+import type { ToolDef } from './tool.js';
+import type { TranscriberDef } from './transcriber.js';
+import type { ViewRendererDef } from './view-renderer.js';
+import type { TunnelProviderDef } from './tunnel.js';
+export type PluginKind = 'tools' | 'provider' | 'mode' | 'compactor' | 'cache-strategy' | 'view-renderer' | 'tunnel-provider' | 'mcp' | 'cli' | 'channel' | 'hooks' | 'agent' | 'command' | 'transcriber';
+export interface PluginSpec {
+    readonly name: string;
+    readonly version?: string;
+    readonly tools?: ReadonlyArray<ToolDef>;
+    readonly providers?: ReadonlyArray<ProviderDef>;
+    readonly modes?: ReadonlyArray<ModeDef>;
+    readonly compactors?: ReadonlyArray<CompactorDef>;
+    /**
+     * Prompt-caching strategies contributed by the plugin. One is active per
+     * session (selected via `session.cacheStrategies.setActive(name)`); the
+     * active strategy decides where cache breakpoints go for each provider call.
+     */
+    readonly cacheStrategies?: ReadonlyArray<CacheStrategyDef>;
+    /**
+     * View-spec renderers contributed by the plugin. One is active per session
+     * (selected via `session.viewRenderers.setActive(name)`); the active renderer
+     * parses the agent's view-spec into a validated AST for `present_view`. A
+     * default renderer ships with core, so this is only for replacing it.
+     */
+    readonly viewRenderers?: ReadonlyArray<ViewRendererDef>;
+    /**
+     * Tunnel providers that expose the local web surface publicly (e.g.
+     * cloudflared). One active per session; core seeds a `localhost` no-op.
+     */
+    readonly tunnelProviders?: ReadonlyArray<TunnelProviderDef>;
+    readonly channels?: ReadonlyArray<ChannelDef>;
+    /**
+     * Speech-to-text backends contributed by the plugin. Selected by name via
+     * `session.transcribers.setActive(name)`; channels with audio input use
+     * `session.transcribers.getActive()` to convert bytes → transcript when
+     * the active provider does not advertise `supportsAudio`.
+     */
+    readonly transcribers?: ReadonlyArray<TranscriberDef>;
+    /**
+     * Typed subagent kinds the plugin contributes. Each becomes
+     * dispatchable as `dispatch_agent({ agentType: <name>, ... })`.
+     * When NO plugin registers any agents (and no plugin registers the
+     * dispatch tool itself), the model has no subagent capability and
+     * the system degrades to the normal single-loop flow.
+     */
+    readonly agents?: ReadonlyArray<AgentDef>;
+    /**
+     * Slash commands contributed to every channel — the TUI's slash
+     * menu, the Telegram bot's command list, and any future channel
+     * that consumes `session.commands`. Use this for actions that make
+     * sense regardless of UI (`/info`, `/clear`, custom domain commands
+     * like `/deploy`); leave channel-specific UI commands (overlay
+     * pickers, raw-mode toggles) inside the channel itself.
+     */
+    readonly commands?: ReadonlyArray<CommandDef>;
+    readonly hooks?: LifecycleHooks;
+    readonly skillsDir?: string;
+}
+export interface Plugin extends PluginSpec {
+    readonly __moxxy: 'plugin';
+    readonly version: string;
+}
+export interface PluginManifest {
+    readonly entry: string;
+    readonly kind?: PluginKind | ReadonlyArray<PluginKind>;
+    readonly skills?: string;
+}
+export interface ResolvedPluginManifest extends PluginManifest {
+    readonly packageName: string;
+    readonly packageVersion: string;
+    readonly packagePath: string;
+    /**
+     * Requirements declared at `package.json#moxxy.requirements`. Statically
+     * authored — never derived from code. Drives plugin toposort and the
+     * pre-load readiness gate.
+     */
+    readonly requirements?: ReadonlyArray<MoxxyRequirement>;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

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

package/dist/plugin.js

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

package/dist/plugin.js.map

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

package/dist/provider-utils.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Small helpers that provider plugins share. Lives in the SDK because plugins
+ * are only allowed to depend on @moxxy/sdk, not core.
+ */
+/** Canonical stop reasons emitted on `message_end` events. */
+export type StopReason = 'end_turn' | 'tool_use' | 'max_tokens' | 'stop_sequence' | 'error';
+/**
+ * Heuristic: should a provider request retry on this error? Used by stream
+ * modes to attach a `retryable: boolean` flag to the `error` event so callers
+ * (or the loop strategy) can decide whether to back off and try again.
+ *
+ * Identical implementation across plugin-provider-anthropic and -openai;
+ * hoisted here so a new provider plugin can stay consistent.
+ */
+export declare function isRetryableError(err: unknown): boolean;
+/**
+ * Build a friendly error event for `ProviderEvent` streams. Tries to classify
+ * the cause as a network failure (turning Node's "fetch failed" into something
+ * actionable) before falling back to the raw message. Providers' catch blocks
+ * yield the result via:
+ *   yield { type: 'error', ...toFriendlyError(err, { provider: this.name }) };
+ */
+export declare function toFriendlyError(err: unknown, ctx?: {
+    readonly url?: string;
+    readonly provider?: string;
+}): {
+    message: string;
+    retryable: boolean;
+};
+/**
+ * Best-effort zod → JSON-schema conversion for provider tool definitions.
+ * Most callers want the basic object/string/number/boolean/array coverage;
+ * for richer schemas, plugins can layer `zod-to-json-schema`.
+ *
+ * The `as unknown as { ... }` casts below probe zod's `_def` internals
+ * (`shape`, `type`) which aren't part of zod's public typed surface but are
+ * stable enough across versions to rely on for this best-effort path.
+ */
+export declare function zodToJsonSchema(schema: unknown): unknown;
+//# sourceMappingURL=provider-utils.d.ts.map

package/dist/provider-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-utils.d.ts","sourceRoot":"","sources":["../src/provider-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,8DAA8D;AAC9D,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,eAAe,GAAG,OAAO,CAAC;AAE5F;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAYtD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,OAAO,EACZ,GAAG,GAAE;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9D;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAYzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAyGxD"}

package/dist/provider-utils.js

@@ -0,0 +1,163 @@
+/**
+ * Small helpers that provider plugins share. Lives in the SDK because plugins
+ * are only allowed to depend on @moxxy/sdk, not core.
+ */
+import { classifyNetworkError } from './errors.js';
+/**
+ * Heuristic: should a provider request retry on this error? Used by stream
+ * modes to attach a `retryable: boolean` flag to the `error` event so callers
+ * (or the loop strategy) can decide whether to back off and try again.
+ *
+ * Identical implementation across plugin-provider-anthropic and -openai;
+ * hoisted here so a new provider plugin can stay consistent.
+ */
+export function isRetryableError(err) {
+    if (!(err instanceof Error))
+        return false;
+    // MoxxyError-classified ones carry the verdict in the code.
+    const code = err.code;
+    if (typeof code === 'string') {
+        if (code === 'PROVIDER_RATE_LIMITED' || code === 'PROVIDER_SERVER_ERROR')
+            return true;
+        if (code === 'NETWORK_TIMEOUT' || code === 'NETWORK_UNREACHABLE')
+            return true;
+    }
+    const msg = err.message.toLowerCase();
+    if (msg.includes('rate_limit') || msg.includes('429') || msg.includes('overloaded'))
+        return true;
+    if (msg.includes('econnreset') || msg.includes('etimedout') || msg.includes('network'))
+        return true;
+    return false;
+}
+/**
+ * Build a friendly error event for `ProviderEvent` streams. Tries to classify
+ * the cause as a network failure (turning Node's "fetch failed" into something
+ * actionable) before falling back to the raw message. Providers' catch blocks
+ * yield the result via:
+ *   yield { type: 'error', ...toFriendlyError(err, { provider: this.name }) };
+ */
+export function toFriendlyError(err, ctx = {}) {
+    const classified = classifyNetworkError(err, ctx);
+    if (classified) {
+        return {
+            message: classified.message + (classified.hint ? ` — ${classified.hint}` : ''),
+            retryable: isRetryableError(classified),
+        };
+    }
+    return {
+        message: err instanceof Error ? err.message : String(err),
+        retryable: isRetryableError(err),
+    };
+}
+/**
+ * Best-effort zod → JSON-schema conversion for provider tool definitions.
+ * Most callers want the basic object/string/number/boolean/array coverage;
+ * for richer schemas, plugins can layer `zod-to-json-schema`.
+ *
+ * The `as unknown as { ... }` casts below probe zod's `_def` internals
+ * (`shape`, `type`) which aren't part of zod's public typed surface but are
+ * stable enough across versions to rely on for this best-effort path.
+ */
+export function zodToJsonSchema(schema) {
+    const s = schema;
+    // Only honor a pre-serialized schema's `toJSON` for NON-zod objects (a plain
+    // JSON-schema object passed through). A real zod schema (has `_def`) MUST go
+    // through the unwrap below — short-circuiting on a zod `toJSON` (some versions
+    // add one) skips the ZodEffects/intersection handling and yields a
+    // properties-less object schema that providers like Codex reject.
+    if (!s._def && typeof s.toJSON === 'function')
+        return s.toJSON();
+    const def = s._def;
+    const typeName = def?.typeName;
+    // ZodEffects (`.refine`, `.transform`, `.superRefine`) is a wrapper —
+    // the inner `schema` field holds the real type. Skipping the unwrap
+    // leaves us with a properties-less object schema, which providers like
+    // Codex's /responses validator reject ("object schema missing properties").
+    if (typeName === 'ZodEffects') {
+        const inner = def.schema;
+        return zodToJsonSchema(inner);
+    }
+    // ZodOptional / ZodNullable / ZodDefault / ZodBranded / ZodReadonly all
+    // wrap an inner schema we want to unwrap for JSON-schema purposes.
+    if (typeName === 'ZodOptional' ||
+        typeName === 'ZodNullable' ||
+        typeName === 'ZodDefault' ||
+        typeName === 'ZodBranded' ||
+        typeName === 'ZodReadonly') {
+        const inner = def.innerType;
+        return zodToJsonSchema(inner);
+    }
+    // `.and(other)` produces a ZodIntersection. The standard JSON-schema
+    // representation is `allOf`, but strict validators (Codex again) want
+    // each branch to be a complete object schema. Easiest path that satisfies
+    // them: when both branches reduce to object schemas, merge properties
+    // and required lists into one object. Fall back to `allOf` otherwise.
+    if (typeName === 'ZodIntersection') {
+        const intersection = def;
+        const left = zodToJsonSchema(intersection.left);
+        const right = zodToJsonSchema(intersection.right);
+        if (left &&
+            right &&
+            left.type === 'object' &&
+            right.type === 'object' &&
+            left.properties &&
+            right.properties) {
+            return {
+                type: 'object',
+                properties: { ...left.properties, ...right.properties },
+                required: Array.from(new Set([
+                    ...(left.required ?? []),
+                    ...(right.required ?? []),
+                ])),
+            };
+        }
+        return { allOf: [left, right] };
+    }
+    if (typeName === 'ZodObject') {
+        // zod's ZodObject._def has a `shape()` thunk returning the field map.
+        const shape = def.shape();
+        const properties = {};
+        const required = [];
+        for (const [key, value] of Object.entries(shape)) {
+            properties[key] = zodToJsonSchema(value);
+            const isOptional = value.isOptional?.();
+            if (!isOptional)
+                required.push(key);
+        }
+        return { type: 'object', properties, required };
+    }
+    if (typeName === 'ZodString')
+        return { type: 'string' };
+    if (typeName === 'ZodNumber')
+        return { type: 'number' };
+    if (typeName === 'ZodBoolean')
+        return { type: 'boolean' };
+    if (typeName === 'ZodEnum') {
+        const values = def.values;
+        return { type: 'string', enum: [...values] };
+    }
+    if (typeName === 'ZodNativeEnum') {
+        const values = Object.values(def.values);
+        const allString = values.every((v) => typeof v === 'string');
+        return { type: allString ? 'string' : 'number', enum: values };
+    }
+    if (typeName === 'ZodLiteral') {
+        const value = def.value;
+        const t = value === null ? 'null' : typeof value;
+        return { type: t, enum: [value] };
+    }
+    if (typeName === 'ZodUnion' || typeName === 'ZodDiscriminatedUnion') {
+        const options = def.options;
+        return { anyOf: options.map((o) => zodToJsonSchema(o)) };
+    }
+    if (typeName === 'ZodArray') {
+        // ZodArray._def.type is the element schema.
+        const items = zodToJsonSchema(def.type);
+        return { type: 'array', items };
+    }
+    // Truly unknown — fall back to a permissive "any object" but spell out
+    // `properties: {}` and `additionalProperties: true` so strict validators
+    // accept the schema instead of bailing on a missing `properties` field.
+    return { type: 'object', properties: {}, additionalProperties: true };
+}
+//# sourceMappingURL=provider-utils.js.map

package/dist/provider-utils.js.map

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

package/dist/provider.d.ts

@@ -0,0 +1,219 @@
+import type { ToolDef } from './tool.js';
+export interface ProviderMessage {
+    readonly role: 'system' | 'user' | 'assistant' | 'tool_result';
+    readonly content: ReadonlyArray<ContentBlock>;
+}
+export type ContentBlock = {
+    readonly type: 'text';
+    readonly text: string;
+} | {
+    readonly type: 'tool_use';
+    readonly id: string;
+    readonly name: string;
+    readonly input: unknown;
+} | {
+    readonly type: 'tool_result';
+    readonly toolUseId: string;
+    readonly content: string;
+    readonly isError?: boolean;
+} | {
+    readonly type: 'image';
+    readonly mediaType: string;
+    readonly data: string;
+} | {
+    readonly type: 'audio';
+    readonly mediaType: string;
+    readonly data: string;
+};
+/**
+ * Provider-neutral instruction for where a prompt-cache breakpoint should be
+ * placed. A {@link CacheStrategyDef} emits these; providers that support
+ * caching (e.g. Anthropic via `cache_control`) translate them into their
+ * native marker, and providers that don't simply ignore them.
+ *
+ * `tools` / `system` mark the end of those (session-stable) regions;
+ * `{ messageIndex }` marks the end of the message at that index in the
+ * request's `messages` array (used for the rolling prefix breakpoint).
+ * Anthropic honors at most 4 breakpoints per request.
+ */
+export interface CacheHint {
+    readonly target: 'tools' | 'system' | {
+        readonly messageIndex: number;
+    };
+}
+export interface ProviderRequest {
+    readonly model: string;
+    readonly system?: string;
+    readonly messages: ReadonlyArray<ProviderMessage>;
+    readonly tools?: ReadonlyArray<ToolDef>;
+    readonly maxTokens?: number;
+    readonly temperature?: number;
+    readonly signal?: AbortSignal;
+    /** Where to place prompt-cache breakpoints. Set by the active CacheStrategy. */
+    readonly cacheHints?: ReadonlyArray<CacheHint>;
+}
+export type ProviderEvent = {
+    readonly type: 'message_start';
+    readonly model: string;
+} | {
+    readonly type: 'text_delta';
+    readonly delta: string;
+} | {
+    readonly type: 'tool_use_start';
+    readonly id: string;
+    readonly name: string;
+} | {
+    readonly type: 'tool_use_delta';
+    readonly id: string;
+    readonly partialInput: string;
+} | {
+    readonly type: 'tool_use_end';
+    readonly id: string;
+    readonly input: unknown;
+} | {
+    readonly type: 'message_end';
+    readonly stopReason: 'end_turn' | 'tool_use' | 'max_tokens' | 'stop_sequence' | 'error';
+    readonly usage?: TokenUsage;
+} | {
+    readonly type: 'error';
+    readonly message: string;
+    readonly retryable: boolean;
+};
+export interface TokenUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens?: number;
+    readonly cacheCreationTokens?: number;
+}
+export interface ModelDescriptor {
+    readonly id: string;
+    readonly contextWindow: number;
+    readonly maxOutputTokens?: number;
+    readonly supportsTools: boolean;
+    readonly supportsStreaming: boolean;
+    /**
+     * Whether this model accepts `image` ContentBlocks in user messages.
+     * Channels gate image attachments on this flag — if a user drops an
+     * image while a non-vision model is active, the channel either
+     * refuses or warns instead of silently dropping the bytes.
+     */
+    readonly supportsImages?: boolean;
+    /**
+     * Whether this model accepts `audio` ContentBlocks in user messages
+     * (GPT-4o, Gemini-Live-class models). When false, channels with audio
+     * input route through the session's active `Transcriber` and forward
+     * the transcript as text instead.
+     */
+    readonly supportsAudio?: boolean;
+}
+export interface LLMProvider {
+    readonly name: string;
+    readonly models: ReadonlyArray<ModelDescriptor>;
+    stream(req: ProviderRequest): AsyncIterable<ProviderEvent>;
+    countTokens(req: Pick<ProviderRequest, 'model' | 'messages' | 'system' | 'tools'>): Promise<number>;
+}
+export type ProviderKeyValidation = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+/**
+ * Minimal vault interface exposed to provider auth flows. Implementations
+ * (typically `@moxxy/plugin-vault`) supply encrypted storage; the auth
+ * descriptor doesn't need anything richer, so we keep the contract small
+ * and SDK-Node-free.
+ */
+export interface ProviderVault {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, tags?: ReadonlyArray<string>): Promise<void>;
+    delete?(key: string): Promise<boolean>;
+}
+/**
+ * Runtime supplied to a provider's OAuth `login(ctx)` callback. The host
+ * (e.g. `moxxy init`, `moxxy login <provider>`) constructs this and hands
+ * it off; the provider plugin runs the flow end-to-end and persists
+ * credentials via `ctx.vault`.
+ */
+export interface ProviderAuthContext {
+    readonly vault: ProviderVault;
+    /**
+     * True when there is no usable browser or interactive TTY. OAuth flows
+     * should fall back to device-code (or equivalent) in this mode rather
+     * than spawning a local callback server / opening a browser.
+     */
+    readonly headless: boolean;
+    /**
+     * Progress-message sink. The host wires this to its preferred renderer
+     * (clack `log.*`, plain stdout, …) so providers don't have to know
+     * whether they're running inside a wizard or a one-shot command.
+     */
+    readonly write: (chunk: string) => void;
+}
+export interface ProviderOAuthResult {
+    /** Human-readable account identifier shown in the success message. */
+    readonly accountId?: string | null;
+    /** UNIX-ms expiry of the persisted credential; surfaced to users. */
+    readonly expiresAt?: number;
+}
+/**
+ * Self-describing auth metadata a provider plugin attaches to its
+ * `ProviderDef`. Lets the CLI's setup wizard and `moxxy login` operate
+ * generically over any installed provider — no CLI-side branch table.
+ *
+ * `apiKey`  : the host prompts for a key and calls `validateKey` (if any).
+ * `oauth`   : the host hands the provider a `ProviderAuthContext`; the
+ *             provider drives the full OAuth dance, including any local
+ *             callback server, and persists tokens to `ctx.vault`.
+ */
+export type ProviderAuthDescriptor = {
+    readonly kind: 'apiKey';
+    /** Canonical env-var name (e.g. `ANTHROPIC_API_KEY`). Inferred when omitted. */
+    readonly envVar?: string;
+    /** Short hint shown next to the prompt (e.g. "starts with `sk-ant-`"). */
+    readonly hint?: string;
+} | {
+    readonly kind: 'oauth';
+    /** Human-readable name of the upstream service (e.g. "ChatGPT Pro/Plus"). */
+    readonly serviceName?: string;
+    /**
+     * Drive the OAuth flow and persist credentials. Throws on failure /
+     * user cancellation; the host typically offers a retry prompt.
+     */
+    login(ctx: ProviderAuthContext): Promise<ProviderOAuthResult>;
+    /**
+     * Optional logout — remove persisted credentials from the vault.
+     * Returns true if anything was removed, false if there was nothing
+     * stored. Used by `moxxy login logout <provider>`.
+     */
+    logout?(ctx: ProviderAuthContext): Promise<boolean>;
+    /**
+     * Optional status probe — returns a brief description of the stored
+     * credential, or null if none. Used by `moxxy login status`.
+     */
+    status?(ctx: ProviderAuthContext): Promise<ProviderOAuthStatus | null>;
+};
+export interface ProviderOAuthStatus {
+    readonly accountId?: string | null;
+    readonly expiresAt?: number;
+    /** Vault key the credentials are stored under (informational). */
+    readonly vaultKey?: string;
+}
+export interface ProviderDef {
+    readonly name: string;
+    readonly models: ReadonlyArray<ModelDescriptor>;
+    createClient(config: Record<string, unknown>): LLMProvider;
+    /**
+     * Optional check that the given key is actually accepted by the vendor.
+     * Implementations should be cheap (a free metadata call or a 1-token
+     * completion). Used by `moxxy init` to verify keys before persisting.
+     */
+    validateKey?(apiKey: string): Promise<ProviderKeyValidation>;
+    /**
+     * Optional auth descriptor. When omitted, the host treats the provider
+     * as `{ kind: 'apiKey' }` — i.e. prompt for a key, call `validateKey`
+     * if defined, store under the canonical vault entry.
+     */
+    readonly auth?: ProviderAuthDescriptor;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

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

package/dist/provider.js

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

package/dist/provider.js.map

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

package/dist/requirements.d.ts

@@ -0,0 +1,22 @@
+export type RequirementKind = 'plugin' | 'provider' | 'tool' | 'transcriber' | 'mode' | 'compactor' | 'channel' | 'agent' | 'command' | 'runtime';
+export type RequirementState = 'registered' | 'active' | 'ready';
+export interface MoxxyRequirement {
+    readonly kind: RequirementKind;
+    readonly name: string;
+    readonly state?: RequirementState;
+    readonly version?: string;
+    readonly optional?: boolean;
+    readonly reason?: string;
+    readonly hint?: string;
+}
+export interface RequirementIssue {
+    readonly requirement: MoxxyRequirement;
+    readonly code: 'missing' | 'inactive' | 'not_ready' | 'version_mismatch';
+    readonly message: string;
+    readonly hint?: string;
+}
+export interface RequirementCheck {
+    readonly ready: boolean;
+    readonly issues: ReadonlyArray<RequirementIssue>;
+}
+//# sourceMappingURL=requirements.d.ts.map

package/dist/requirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements.d.ts","sourceRoot":"","sources":["../src/requirements.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,UAAU,GACV,MAAM,GACN,aAAa,GACb,MAAM,GACN,WAAW,GACX,SAAS,GACT,OAAO,GACP,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,kBAAkB,CAAC;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CAClD"}

package/dist/requirements.js

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

package/dist/requirements.js.map

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