@demicodes/provider 0.3.2 → 0.4.1

package/dist/credentials-pool.d.mts

@@ -1,4 +1,4 @@
-import { d as ProviderCredentialInfo } from "./types-C9tIelAP.mjs";
+import { d as ProviderCredentialInfo } from "./types-DbFB3sp6.mjs";
 //#region src/credentials-pool.d.ts
 interface CredentialEntryMeta {
   id: string;
@@ -56,11 +56,5 @@ declare class CredentialPoolError extends Error {
   readonly code: 'credential_not_found' | 'credential_invalid';
   constructor(code: 'credential_not_found' | 'credential_invalid', message: string);
 }
-declare function runVendorLoginCommand(command: string, args: string[], options?: {
-  signal?: AbortSignal;
-}): Promise<{
-  status: 'completed' | 'cancelled' | 'failed' | 'unavailable';
-  message?: string;
-}>;
 //#endregion
-export { CredentialEntryMeta, CredentialPoolError, FileCredentialPool, FileCredentialPoolOptions, credentialIdFromIdentity, newCredentialId, resolveDemiHome, runVendorLoginCommand };
+export { CredentialEntryMeta, CredentialPoolError, FileCredentialPool, FileCredentialPoolOptions, credentialIdFromIdentity, newCredentialId, resolveDemiHome };

package/dist/credentials-pool.mjs

@@ -201,62 +201,5 @@ var CredentialPoolError = class extends Error {
 		this.name = "CredentialPoolError";
 	}
 };
-async function runVendorLoginCommand(command, args, options = {}) {
-	const { spawn } = await import("node:child_process");
-	return new Promise((resolvePromise) => {
-		let child;
-		try {
-			child = spawn(command, args, {
-				stdio: "inherit",
-				env: process.env,
-				shell: false
-			});
-		} catch (error) {
-			resolvePromise({
-				status: "unavailable",
-				message: error instanceof Error ? error.message : String(error)
-			});
-			return;
-		}
-		const onAbort = () => {
-			child.kill("SIGTERM");
-		};
-		if (options.signal) {
-			if (options.signal.aborted) {
-				child.kill("SIGTERM");
-				resolvePromise({ status: "cancelled" });
-				return;
-			}
-			options.signal.addEventListener("abort", onAbort, { once: true });
-		}
-		child.on("error", (error) => {
-			options.signal?.removeEventListener("abort", onAbort);
-			const msg = error instanceof Error ? error.message : String(error);
-			if (errorCode(error) === "ENOENT") {
-				resolvePromise({
-					status: "unavailable",
-					message: `Command not found: ${command}`
-				});
-				return;
-			}
-			resolvePromise({
-				status: "failed",
-				message: msg
-			});
-		});
-		child.on("exit", (code, signal) => {
-			options.signal?.removeEventListener("abort", onAbort);
-			if (options.signal?.aborted || signal === "SIGTERM" || signal === "SIGINT") {
-				resolvePromise({ status: "cancelled" });
-				return;
-			}
-			if (code === 0) resolvePromise({ status: "completed" });
-			else resolvePromise({
-				status: "failed",
-				message: `${command} exited with code ${code ?? "null"}`
-			});
-		});
-	});
-}
 //#endregion
-export { CredentialPoolError, FileCredentialPool, credentialIdFromIdentity, newCredentialId, resolveDemiHome, runVendorLoginCommand };
+export { CredentialPoolError, FileCredentialPool, credentialIdFromIdentity, newCredentialId, resolveDemiHome };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { A as ProviderQuotaCapability, B as ProviderQuotaWindow, C as ProviderRuntimeState, D as CreateProviderQuotaOptions, E as ToolDefinition, F as ProviderQuotaProbeResult, G as severityFromUsedPercent, H as clampUsedPercent, I as ProviderQuotaSeverity, K as unixSecondsToIso, L as ProviderQuotaSnapshot, M as ProviderQuotaPlan, N as ProviderQuotaProbeCost, O as EnsureQuotaOptions, P as ProviderQuotaProbeOptions, R as ProviderQuotaSource, S as ProviderRuntimeFactory, T as ProviderServiceTier, U as createProviderQuota, V as ProviderQuotaWindowUnit, W as ensureQuota, _ as ProviderFactoryDefinition, a as ModelPolicy, b as ProviderModelList, c as ProviderAuthState, d as ProviderCredentialInfo, f as ProviderCredentialLoginOptions, g as ProviderEvent, h as ProviderCredentialsCapability, i as InferenceSteer, j as ProviderQuotaObserveInput, k as ProviderQuota, l as ProviderCredentialActive, m as ProviderCredentials, n as InferenceItem, o as Provider, p as ProviderCredentialLoginResult, q as usedPercentFromRatio, r as InferenceRequest, s as ProviderAuth, t as AgentProvider, u as ProviderCredentialAddInput, v as ProviderModel, w as ProviderSelection, x as ProviderRun, y as ProviderModelCost, z as ProviderQuotaUnsupportedError } from "./types-C9tIelAP.mjs";
+import { A as ProviderQuota, B as ProviderQuotaUnsupportedError, C as ProviderRuntimeFactory, D as ToolDefinition, E as ProviderServiceTier, F as ProviderQuotaProbeOptions, G as ensureQuota, H as ProviderQuotaWindowUnit, I as ProviderQuotaProbeResult, J as usedPercentFromRatio, K as severityFromUsedPercent, L as ProviderQuotaSeverity, M as ProviderQuotaObserveInput, N as ProviderQuotaPlan, O as CreateProviderQuotaOptions, P as ProviderQuotaProbeCost, R as ProviderQuotaSnapshot, S as ProviderRun, T as ProviderSelection, U as clampUsedPercent, V as ProviderQuotaWindow, W as createProviderQuota, _ as ProviderEvent, a as ModelPolicy, b as ProviderModelCost, c as ProviderAuthState, d as ProviderCredentialInfo, f as ProviderCredentialLoginOptions, g as ProviderCredentialsCapability, h as ProviderCredentials, i as InferenceSteer, j as ProviderQuotaCapability, k as EnsureQuotaOptions, l as ProviderCredentialActive, m as ProviderCredentialLoginResult, n as InferenceItem, o as Provider, p as ProviderCredentialLoginPending, q as unixSecondsToIso, r as InferenceRequest, s as ProviderAuth, t as AgentProvider, u as ProviderCredentialAddInput, v as ProviderFactoryDefinition, w as ProviderRuntimeState, x as ProviderModelList, y as ProviderModel, z as ProviderQuotaSource } from "./types-DbFB3sp6.mjs";
 import { FileExtension, ModelSelection, ThinkingCapability, ThinkingConfig, ToolResultContentBlock } from "@demicodes/core";
 //#region src/content.d.ts
 /**
@@ -64,4 +64,4 @@ declare function numberHeader(headers: Headers, name: string): number | null;
 /** Builds a redacted provider `error` event from a failed HTTP response. */
 declare function httpRequestFailedEvent(response: Response, secret: string | null | undefined, providerLabel: string): Promise<ProviderEvent>;
 //#endregion
-export { AgentProvider, type CreateProviderQuotaOptions, DEFAULT_ATTACHMENT_EXTENSIONS, type EnsureQuotaOptions, InferenceItem, InferenceRequest, InferenceSteer, ModelPolicy, type ModelSelectionFromCatalogOptions, Provider, ProviderAuth, ProviderAuthState, ProviderCredentialActive, ProviderCredentialAddInput, ProviderCredentialInfo, ProviderCredentialLoginOptions, ProviderCredentialLoginResult, ProviderCredentials, ProviderCredentialsCapability, ProviderEvent, ProviderFactoryDefinition, ProviderModel, ProviderModelCost, ProviderModelList, type ProviderQuota, type ProviderQuotaCapability, type ProviderQuotaObserveInput, type ProviderQuotaPlan, type ProviderQuotaProbeCost, type ProviderQuotaProbeOptions, type ProviderQuotaProbeResult, type ProviderQuotaSeverity, type ProviderQuotaSnapshot, type ProviderQuotaSource, ProviderQuotaUnsupportedError, type ProviderQuotaWindow, type ProviderQuotaWindowUnit, ProviderRun, ProviderRuntimeFactory, ProviderRuntimeState, ProviderSelection, ProviderServiceTier, ToolDefinition, applyModelPolicy, authStatusFromKey, clampPromptCacheKey, clampUsedPercent, createProviderQuota, defineProvider, ensureQuota, httpErrorCode, httpRequestFailedEvent, modelSelectionFromCatalog, normalizeErrorCode, numberHeader, providerErrorFromUnknown, providerRuntime, redactCredentialText, redactSecretText, retryAfterMsFromHeader, severityFromUsedPercent, thinkingCapabilitiesFromProviderModel, toolResultContentToText, unixSecondsToIso, usedPercentFromRatio, withProviderId };
+export { AgentProvider, type CreateProviderQuotaOptions, DEFAULT_ATTACHMENT_EXTENSIONS, type EnsureQuotaOptions, InferenceItem, InferenceRequest, InferenceSteer, ModelPolicy, type ModelSelectionFromCatalogOptions, Provider, ProviderAuth, ProviderAuthState, ProviderCredentialActive, ProviderCredentialAddInput, ProviderCredentialInfo, ProviderCredentialLoginOptions, ProviderCredentialLoginPending, ProviderCredentialLoginResult, ProviderCredentials, ProviderCredentialsCapability, ProviderEvent, ProviderFactoryDefinition, ProviderModel, ProviderModelCost, ProviderModelList, type ProviderQuota, type ProviderQuotaCapability, type ProviderQuotaObserveInput, type ProviderQuotaPlan, type ProviderQuotaProbeCost, type ProviderQuotaProbeOptions, type ProviderQuotaProbeResult, type ProviderQuotaSeverity, type ProviderQuotaSnapshot, type ProviderQuotaSource, ProviderQuotaUnsupportedError, type ProviderQuotaWindow, type ProviderQuotaWindowUnit, ProviderRun, ProviderRuntimeFactory, ProviderRuntimeState, ProviderSelection, ProviderServiceTier, ToolDefinition, applyModelPolicy, authStatusFromKey, clampPromptCacheKey, clampUsedPercent, createProviderQuota, defineProvider, ensureQuota, httpErrorCode, httpRequestFailedEvent, modelSelectionFromCatalog, normalizeErrorCode, numberHeader, providerErrorFromUnknown, providerRuntime, redactCredentialText, redactSecretText, retryAfterMsFromHeader, severityFromUsedPercent, thinkingCapabilitiesFromProviderModel, toolResultContentToText, unixSecondsToIso, usedPercentFromRatio, withProviderId };

package/dist/testing.d.mts

@@ -1,4 +1,4 @@
-import { g as ProviderEvent, i as InferenceSteer, r as InferenceRequest, t as AgentProvider, x as ProviderRun } from "./types-C9tIelAP.mjs";
+import { S as ProviderRun, _ as ProviderEvent, i as InferenceSteer, r as InferenceRequest, t as AgentProvider } from "./types-DbFB3sp6.mjs";
 //#region src/testing.d.ts
 /**
  * Scripted provider for testing. Each "turn" is a list of events to yield.

package/dist/{types-C9tIelAP.d.mts → types-DbFB3sp6.d.mts}

@@ -280,18 +280,39 @@ interface ProviderCredentialActive {
   /** Same shape as auth status, for the active credential. */
   status: ProviderAuthState;
 }
+/**
+ * User-facing material issued mid-flow by a device-code login: the product
+ * relays it to the user, who completes login from any browser on any device.
+ */
+interface ProviderCredentialLoginPending {
+  /** URL the user opens to confirm the login. */
+  verificationUrl: string;
+  /** One-time code the user enters at the verification URL (device-code flows). */
+  userCode?: string | null;
+  /** ISO-8601 expiry of the code, when the vendor exposes one. */
+  expiresAt?: string | null;
+  /**
+   * True when the vendor displays a code AFTER approval that the user must
+   * bring back; the product collects it via `promptForCode`.
+   */
+  requiresCodeInput?: boolean;
+}
 interface ProviderCredentialLoginOptions {
-  /** Abort the spawned login process. */
+  /** Abort the login flow. */
   signal?: AbortSignal;
-  /** Prefer browser vs device/CLI when the vendor supports both; best-effort. */
-  preferBrowser?: boolean;
+  /** Fires once when the flow issues user-facing material (device-code login). */
+  onPending?: (pending: ProviderCredentialLoginPending) => void;
+  /** Collects the code the user copied back from the vendor page (`requiresCodeInput` flows). */
+  promptForCode?: () => Promise<string>;
 }
 /**
- * Login invoke result — status of the *vendor* process only, not a pool id.
- * Demi does not complete OAuth; product should `importDefault` afterwards.
+ * Login invoke result. Every login flow runs the vendor's public protocol
+ * natively, imports the resulting material into the pool, and returns the
+ * pool `credentialId`.
  */
 type ProviderCredentialLoginResult = {
   status: 'completed';
+  credentialId: string;
 } | {
   status: 'cancelled';
 } | {
@@ -312,7 +333,7 @@ type ProviderCredentialsCapability = {
   mode: 'none';
 } | {
   mode: 'supported';
-  /** Can spawn / open vendor login (`beginLogin`). */
+  /** Can run the vendor's native login flow (`beginLogin`). */
   canBeginLogin?: boolean;
   /** Can import from the vendor default location into the pool. */
   canImportDefault?: boolean;
@@ -335,8 +356,9 @@ interface ProviderCredentials {
    */
   setActive(credentialId: string): Promise<ProviderCredentialActive> | ProviderCredentialActive;
   /**
-   * Invoke the vendor’s own login flow. Does not complete OAuth inside demi
-   * and does not return a credential id.
+   * Run the vendor's public login protocol natively (device code or copy-back
+   * OAuth), surfacing user-facing material via `onPending`. On completion the
+   * material is imported into the pool and its `credentialId` is returned.
    */
   beginLogin?(options?: ProviderCredentialLoginOptions): Promise<ProviderCredentialLoginResult>;
   /**
@@ -430,4 +452,4 @@ type ModelPolicy = {
   default?: string;
 };
 //#endregion
-export { ProviderQuotaCapability as A, ProviderQuotaWindow as B, ProviderRuntimeState as C, CreateProviderQuotaOptions as D, ToolDefinition as E, ProviderQuotaProbeResult as F, severityFromUsedPercent as G, clampUsedPercent as H, ProviderQuotaSeverity as I, unixSecondsToIso as K, ProviderQuotaSnapshot as L, ProviderQuotaPlan as M, ProviderQuotaProbeCost as N, EnsureQuotaOptions as O, ProviderQuotaProbeOptions as P, ProviderQuotaSource as R, ProviderRuntimeFactory as S, ProviderServiceTier as T, createProviderQuota as U, ProviderQuotaWindowUnit as V, ensureQuota as W, ProviderFactoryDefinition as _, ModelPolicy as a, ProviderModelList as b, ProviderAuthState as c, ProviderCredentialInfo as d, ProviderCredentialLoginOptions as f, ProviderEvent as g, ProviderCredentialsCapability as h, InferenceSteer as i, ProviderQuotaObserveInput as j, ProviderQuota as k, ProviderCredentialActive as l, ProviderCredentials as m, InferenceItem as n, Provider as o, ProviderCredentialLoginResult as p, usedPercentFromRatio as q, InferenceRequest as r, ProviderAuth as s, AgentProvider as t, ProviderCredentialAddInput as u, ProviderModel as v, ProviderSelection as w, ProviderRun as x, ProviderModelCost as y, ProviderQuotaUnsupportedError as z };
+export { ProviderQuota as A, ProviderQuotaUnsupportedError as B, ProviderRuntimeFactory as C, ToolDefinition as D, ProviderServiceTier as E, ProviderQuotaProbeOptions as F, ensureQuota as G, ProviderQuotaWindowUnit as H, ProviderQuotaProbeResult as I, usedPercentFromRatio as J, severityFromUsedPercent as K, ProviderQuotaSeverity as L, ProviderQuotaObserveInput as M, ProviderQuotaPlan as N, CreateProviderQuotaOptions as O, ProviderQuotaProbeCost as P, ProviderQuotaSnapshot as R, ProviderRun as S, ProviderSelection as T, clampUsedPercent as U, ProviderQuotaWindow as V, createProviderQuota as W, ProviderEvent as _, ModelPolicy as a, ProviderModelCost as b, ProviderAuthState as c, ProviderCredentialInfo as d, ProviderCredentialLoginOptions as f, ProviderCredentialsCapability as g, ProviderCredentials as h, InferenceSteer as i, ProviderQuotaCapability as j, EnsureQuotaOptions as k, ProviderCredentialActive as l, ProviderCredentialLoginResult as m, InferenceItem as n, Provider as o, ProviderCredentialLoginPending as p, unixSecondsToIso as q, InferenceRequest as r, ProviderAuth as s, AgentProvider as t, ProviderCredentialAddInput as u, ProviderFactoryDefinition as v, ProviderRuntimeState as w, ProviderModelList as x, ProviderModel as y, ProviderQuotaSource as z };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@demicodes/provider",
   "description": "Provider contract and shared building blocks for Demi inference adapters.",
-  "version": "0.3.2",
+  "version": "0.4.1",
   "private": false,
   "type": "module",
   "exports": {