@modelprofile.com/authswitch 2.1.2

package/dist_ts/interfaces.harness.d.ts

@@ -0,0 +1,130 @@
+import type { TAuthLoginPrompt, TAuthLoginFlow } from './classes.login.js';
+export interface IHarnessLoginProvider {
+    providerId: string;
+    label: string;
+    flows: TAuthLoginFlow[];
+}
+export interface IHarnessLoginOptions {
+    providerId: string;
+    flow: TAuthLoginFlow;
+}
+export interface IHarnessLoginResult {
+    outcome: IHarnessOutcome;
+    account?: Pick<IHarnessAccount, 'id' | 'label' | 'slotId'>;
+}
+export interface IHarnessLoginHandle {
+    readonly prompt: TAuthLoginPrompt;
+    /** Completion saves the new account without activating it. No credentials cross this interface. */
+    readonly completion: Promise<IHarnessLoginResult>;
+    cancel(): Promise<void>;
+    close(): Promise<void>;
+}
+/** Account IDs are opaque and scoped to one harness. Credentials never cross this interface. */
+export interface IHarnessAccount {
+    id: string;
+    label: string;
+    /** Accounts in different slots can be active together (for example OpenCode providers). */
+    slotId?: string;
+    isActive: boolean;
+    isStashed: boolean;
+    savedAt: string | null;
+    details: string[];
+}
+export interface IHarnessState {
+    accounts: IHarnessAccount[];
+    /** Explains why an active login cannot be saved, when applicable. */
+    saveUnavailableReason: string | null;
+}
+export interface IHarnessAccountStatus {
+    /** Provider-reported facts, already labelled with their units and provenance. */
+    facts: IHarnessStatusFact[];
+    /** Missing/failed information is explicit and never represented as zero usage. */
+    problems: string[];
+    /** Optional structured data for shared presentation; never parse the display facts. */
+    summary?: IHarnessStatusSummary;
+}
+export interface IHarnessStatusFact {
+    label: string;
+    value: string;
+    /** Optional display group; ungrouped adapters use Additional information. */
+    section?: string;
+    /** The fact duplicates this structured field; omit it only when that field is displayed. */
+    summaryKey?: 'subscription' | 'billing' | 'usageWindows' | 'resets' | 'resetDetails';
+}
+export interface IHarnessStatusSummary {
+    /** A plan name does not imply an active billing status. */
+    subscription?: {
+        plan: string;
+        source: 'live' | 'stored';
+    };
+    /** Live billing information only. Never infer these fields from a plan or entitlement expiry. */
+    billing?: {
+        hasActiveSubscription?: boolean;
+        autoRenew?: boolean;
+        renewsAt?: string;
+        cancelsAt?: string;
+        expiresAt?: string;
+    };
+    /** Missing windows are unknown, not unused. Times are ISO 8601 UTC. */
+    usageWindows?: {
+        label: string;
+        /** Feature-specific quotas do not determine the general account summary. Omission means account. */
+        scope?: 'account' | 'feature';
+        durationSeconds: number;
+        usedPercent: number;
+        resetAt: string | null;
+    }[];
+    resets?: {
+        available: number;
+        /** May be a partial list. Omission means the detail lookup was unavailable. */
+        details?: {
+            status: string;
+            kind: string;
+            expiresAt: string | null;
+        }[];
+    };
+}
+export interface IHarnessOutcome {
+    lines: string[];
+    problems: string[];
+}
+/** A single text-only inference request. Credentials remain inside the adapter. */
+export interface IHarnessPreuseOptions {
+    prompt: string;
+    model?: string;
+    signal?: AbortSignal;
+}
+export interface IHarnessPreuseResult {
+    model: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+}
+export type THarnessResult<T> = T | Promise<T>;
+/** Each adapter owns its credential storage, account matching, status API and process lifecycle. */
+export interface IAuthHarness {
+    readonly id: string;
+    readonly label: string;
+    readonly loginHint: string;
+    readonly diagnosticsLabel: string;
+    readState(): THarnessResult<IHarnessState>;
+    readAccountStatus(accountIdArg: string): Promise<IHarnessAccountStatus>;
+    readonly loginProviders?: IHarnessLoginProvider[];
+    beginLogin?(options: IHarnessLoginOptions): Promise<IHarnessLoginHandle>;
+    /** Optional quota-consuming capability; never changes the active login. */
+    preuseAccount?(accountIdArg: string, optionsArg: IHarnessPreuseOptions): Promise<IHarnessPreuseResult>;
+    resolveAccount(referenceArg: string): THarnessResult<{
+        id: string;
+    } | {
+        candidates: string[];
+    }>;
+    saveCurrent(optionsArg: {
+        keepActive: boolean;
+        accountId?: string;
+    }): THarnessResult<IHarnessOutcome>;
+    /** Preserve and verify the outgoing credential even when invoked without the interactive guide. */
+    switchAccount(accountIdArg: string): THarnessResult<IHarnessOutcome>;
+    /** Remove the saved copy only, preserving the active login. */
+    removeAccount(accountIdArg: string): THarnessResult<IHarnessOutcome>;
+    diagnose(): THarnessResult<IHarnessOutcome>;
+}

package/dist_ts/interfaces.harness.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5oYXJuZXNzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvaW50ZXJmYWNlcy5oYXJuZXNzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/dist_ts/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL2ludGVyZmFjZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/dist_ts/interfaces.list.d.ts

@@ -0,0 +1,19 @@
+import type { IHarnessAccount, IHarnessAccountStatus } from './interfaces.harness.js';
+/** Credential-free, versioned output of list --json. Missing status fields stay omitted. */
+export interface IAccountList {
+    schemaVersion: 2;
+    generatedAt: string;
+    complete: boolean;
+    harnesses: IHarnessAccountList[];
+}
+export interface IHarnessAccountList {
+    id: string;
+    label: string;
+    loginHint: string;
+    saveUnavailableReason: string | null;
+    accounts: (IHarnessAccount & {
+        status: IHarnessAccountStatus;
+    })[];
+    /** A state lookup failure is distinct from an empty account list. */
+    problems: string[];
+}

package/dist_ts/interfaces.list.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5saXN0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvaW50ZXJmYWNlcy5saXN0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/dist_ts/plugins.d.ts

@@ -0,0 +1,14 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import * as childProcess from 'node:child_process';
+import * as crypto from 'node:crypto';
+import { DatabaseSync } from 'node:sqlite';
+export { childProcess, crypto, fs, os, path, DatabaseSync };
+import * as smartconsole from '@push.rocks/smartconsole';
+export { smartconsole };
+import * as flexModels from '@modelprofile.com/flexharness-models';
+import * as flexOpenAi from '@modelprofile.com/flexharness-providers/openai';
+import * as flexAuth from '@modelprofile.com/flexharness-providers/auth';
+import * as flexAccounts from '@modelprofile.com/flexharness-providers/accounts';
+export { flexModels, flexOpenAi, flexAuth, flexAccounts };

package/dist_ts/plugins.js

@@ -0,0 +1,18 @@
+// Node native modules
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import * as childProcess from 'node:child_process';
+import * as crypto from 'node:crypto';
+import { DatabaseSync } from 'node:sqlite';
+export { childProcess, crypto, fs, os, path, DatabaseSync };
+// @push.rocks modules
+import * as smartconsole from '@push.rocks/smartconsole';
+export { smartconsole };
+// @modelprofile.com modules
+import * as flexModels from '@modelprofile.com/flexharness-models';
+import * as flexOpenAi from '@modelprofile.com/flexharness-providers/openai';
+import * as flexAuth from '@modelprofile.com/flexharness-providers/auth';
+import * as flexAccounts from '@modelprofile.com/flexharness-providers/accounts';
+export { flexModels, flexOpenAi, flexAuth, flexAccounts };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsc0JBQXNCO0FBQ3RCLE9BQU8sS0FBSyxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQzlCLE9BQU8sS0FBSyxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQzlCLE9BQU8sS0FBSyxJQUFJLE1BQU0sV0FBVyxDQUFDO0FBQ2xDLE9BQU8sS0FBSyxZQUFZLE1BQU0sb0JBQW9CLENBQUM7QUFDbkQsT0FBTyxLQUFLLE1BQU0sTUFBTSxhQUFhLENBQUM7QUFDdEMsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUUzQyxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLElBQUksRUFBRSxZQUFZLEVBQUUsQ0FBQztBQUU1RCxzQkFBc0I7QUFDdEIsT0FBTyxLQUFLLFlBQVksTUFBTSwwQkFBMEIsQ0FBQztBQUN6RCxPQUFPLEVBQUUsWUFBWSxFQUFFLENBQUM7QUFFeEIsNEJBQTRCO0FBQzVCLE9BQU8sS0FBSyxVQUFVLE1BQU0sc0NBQXNDLENBQUM7QUFDbkUsT0FBTyxLQUFLLFVBQVUsTUFBTSxnREFBZ0QsQ0FBQztBQUM3RSxPQUFPLEtBQUssUUFBUSxNQUFNLDhDQUE4QyxDQUFDO0FBQ3pFLE9BQU8sS0FBSyxZQUFZLE1BQU0sa0RBQWtELENBQUM7QUFDakYsT0FBTyxFQUFFLFVBQVUsRUFBRSxVQUFVLEVBQUUsUUFBUSxFQUFFLFlBQVksRUFBRSxDQUFDIn0=

package/dist_ts/preuse.d.ts

@@ -0,0 +1,6 @@
+import type { IHarnessPreuseOptions } from './interfaces.harness.js';
+export declare const defaultPreusePrompt = "Write 2000 words about strawberries.";
+/** Only fixed local messages may cross the inference error boundary. */
+export declare class PreuseError extends Error {
+}
+export declare const validatePreuseOptions: (optionsArg: IHarnessPreuseOptions) => void;

package/dist_ts/preuse.js

@@ -0,0 +1,13 @@
+export const defaultPreusePrompt = 'Write 2000 words about strawberries.';
+/** Only fixed local messages may cross the inference error boundary. */
+export class PreuseError extends Error {
+}
+export const validatePreuseOptions = (optionsArg) => {
+    if (typeof optionsArg.prompt !== 'string' || !optionsArg.prompt.trim() || Buffer.byteLength(optionsArg.prompt, 'utf8') > 16_384) {
+        throw new PreuseError('The preuse prompt must contain between 1 and 16384 UTF-8 bytes.');
+    }
+    if (optionsArg.model !== undefined && (typeof optionsArg.model !== 'string' || !/^[a-zA-Z0-9][a-zA-Z0-9._:/-]{0,127}$/.test(optionsArg.model))) {
+        throw new PreuseError('The preuse model must be a valid model identifier of at most 128 characters.');
+    }
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJldXNlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvcHJldXNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE1BQU0sQ0FBQyxNQUFNLG1CQUFtQixHQUFHLHNDQUFzQyxDQUFDO0FBRTFFLHdFQUF3RTtBQUN4RSxNQUFNLE9BQU8sV0FBWSxTQUFRLEtBQUs7Q0FBRztBQUV6QyxNQUFNLENBQUMsTUFBTSxxQkFBcUIsR0FBRyxDQUFDLFVBQWlDLEVBQVEsRUFBRTtJQUMvRSxJQUFJLE9BQU8sVUFBVSxDQUFDLE1BQU0sS0FBSyxRQUFRLElBQUksQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLElBQUksRUFBRSxJQUFJLE1BQU0sQ0FBQyxVQUFVLENBQUMsVUFBVSxDQUFDLE1BQU0sRUFBRSxNQUFNLENBQUMsR0FBRyxNQUFNLEVBQUUsQ0FBQztRQUNoSSxNQUFNLElBQUksV0FBVyxDQUFDLGlFQUFpRSxDQUFDLENBQUM7SUFDM0YsQ0FBQztJQUNELElBQUksVUFBVSxDQUFDLEtBQUssS0FBSyxTQUFTLElBQUksQ0FBQyxPQUFPLFVBQVUsQ0FBQyxLQUFLLEtBQUssUUFBUSxJQUFJLENBQUMsc0NBQXNDLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLENBQUM7UUFDL0ksTUFBTSxJQUFJLFdBQVcsQ0FBQyw4RUFBOEUsQ0FBQyxDQUFDO0lBQ3hHLENBQUM7QUFDSCxDQUFDLENBQUMifQ==

package/license.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Task Venture Capital GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@modelprofile.com/authswitch",
+  "version": "2.1.2",
+  "private": false,
+  "description": "Manage Codex, OpenCode and Claude Code accounts with guided switching and live usage status",
+  "main": "dist_ts/index.js",
+  "typings": "dist_ts/index.d.ts",
+  "type": "module",
+  "author": "Task Venture Capital GmbH",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://code.foss.global/modelprofile.com/authswitch.git"
+  },
+  "homepage": "https://code.foss.global/modelprofile.com/authswitch",
+  "bugs": {
+    "url": "https://community.foss.global/"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "bin": {
+    "authswitch": "./cli.js"
+  },
+  "devDependencies": {
+    "@git.zone/tsbuild": "^4.4.3",
+    "@git.zone/tsrun": "^2.0.6",
+    "@git.zone/tstest": "^6.0.0",
+    "@types/node": "^26.4.1"
+  },
+  "dependencies": {
+    "@modelprofile.com/flexharness-models": "^7.0.1",
+    "@modelprofile.com/flexharness-providers": "^7.0.1",
+    "@push.rocks/smartconsole": "^1.1.0"
+  },
+  "files": [
+    "ts/**/*",
+    "dist_ts/**/*",
+    "cli.js",
+    ".smartconfig.json",
+    "readme.md"
+  ],
+  "browserslist": [
+    "last 1 chrome versions"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "(tstest test/ --verbose)",
+    "build": "(tsbuild)"
+  }
+}