@chatbridge/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 7milch
+
+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/README.md

@@ -0,0 +1,3 @@
+# @chatbridge/core
+
+Core session flows and errors for [chatbridge](https://github.com/7milch/chatbridge-cli).

package/dist/create-auth-store.d.ts

@@ -0,0 +1,4 @@
+import { AuthStore, type AuthStoreOptions } from "@chatbridge/runtime";
+/** Builds an AuthStore, translating an unusable provider name into the
+ * framework error the CLI maps to exit code 5. */
+export declare function createAuthStore(opts: AuthStoreOptions): AuthStore;

package/dist/create-auth-store.js

@@ -0,0 +1,13 @@
+import { AuthStore, validateProviderName, } from "@chatbridge/runtime";
+import { InvalidProviderError } from "./errors.js";
+/** Builds an AuthStore, translating an unusable provider name into the
+ * framework error the CLI maps to exit code 5. */
+export function createAuthStore(opts) {
+    try {
+        validateProviderName(opts.providerName);
+    }
+    catch (err) {
+        throw new InvalidProviderError(`Provider name ${JSON.stringify(opts.providerName)} cannot be used as a file name: use lowercase letters, digits, ".", "_" or "-" (1-64 chars, starting with a letter or digit).`, { cause: err });
+    }
+    return new AuthStore(opts);
+}

package/dist/errors.d.ts

@@ -0,0 +1,22 @@
+/** Base class for all framework errors. The CLI maps `code` to exit codes.
+ * `options.cause` carries the underlying error (never auth content). */
+export declare class ChatBridgeError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string, options?: ErrorOptions);
+}
+export declare class AuthRequiredError extends ChatBridgeError {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class AuthExpiredError extends ChatBridgeError {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class ResponseTimeoutError extends ChatBridgeError {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class ProviderLoadError extends ChatBridgeError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** The provider's `name` cannot be used as an auth-state file name. */
+export declare class InvalidProviderError extends ChatBridgeError {
+    constructor(message: string, options?: ErrorOptions);
+}

package/dist/errors.js

@@ -0,0 +1,36 @@
+/** Base class for all framework errors. The CLI maps `code` to exit codes.
+ * `options.cause` carries the underlying error (never auth content). */
+export class ChatBridgeError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.code = code;
+        this.name = new.target.name;
+    }
+}
+export class AuthRequiredError extends ChatBridgeError {
+    constructor(message, options) {
+        super("AUTH_REQUIRED", message, options);
+    }
+}
+export class AuthExpiredError extends ChatBridgeError {
+    constructor(message, options) {
+        super("AUTH_EXPIRED", message, options);
+    }
+}
+export class ResponseTimeoutError extends ChatBridgeError {
+    constructor(message, options) {
+        super("RESPONSE_TIMEOUT", message, options);
+    }
+}
+export class ProviderLoadError extends ChatBridgeError {
+    constructor(message, options) {
+        super("PROVIDER_LOAD", message, options);
+    }
+}
+/** The provider's `name` cannot be used as an auth-state file name. */
+export class InvalidProviderError extends ChatBridgeError {
+    constructor(message, options) {
+        super("INVALID_PROVIDER", message, options);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./errors.js";
+export { type LoginOptions, type OneShotOptions, runLogin, runOneShot, } from "./session.js";
+export { createAuthStore } from "./create-auth-store.js";
+export { AuthStore, type AuthStoreOptions, BrowserRuntime, validateProviderName, } from "@chatbridge/runtime";
+export type { Provider } from "@chatbridge/provider";
+export { defineProvider } from "@chatbridge/provider";

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./errors.js";
+export { runLogin, runOneShot, } from "./session.js";
+export { createAuthStore } from "./create-auth-store.js";
+export { AuthStore, BrowserRuntime, validateProviderName, } from "@chatbridge/runtime";
+export { defineProvider } from "@chatbridge/provider";

package/dist/session.d.ts

@@ -0,0 +1,23 @@
+import type { Provider } from "@chatbridge/provider";
+import { type AuthStore } from "@chatbridge/runtime";
+export interface OneShotOptions {
+    provider: Provider;
+    authStore: AuthStore;
+    prompt: string;
+    headless: boolean;
+    timeoutMs: number;
+    /** Progress messages (stderr in the CLI). Never receives auth content. */
+    onProgress?: (message: string) => void;
+}
+/** Runs one browser step; a Playwright TimeoutError becomes a framework
+ * ResponseTimeoutError that names the step and keeps the original as cause. */
+export declare function runStep<T>(name: string, timeoutMs: number, fn: () => Promise<T>): Promise<T>;
+/** One-shot flow: restore auth -> new chat -> send -> wait -> return text. */
+export declare function runOneShot(opts: OneShotOptions): Promise<string>;
+export interface LoginOptions {
+    provider: Provider;
+    authStore: AuthStore;
+    onProgress?: (message: string) => void;
+}
+/** Headful login flow: the user logs in manually; we poll for completion. */
+export declare function runLogin(opts: LoginOptions): Promise<void>;

package/dist/session.js

@@ -0,0 +1,71 @@
+import { BrowserRuntime } from "@chatbridge/runtime";
+import { AuthExpiredError, AuthRequiredError, ResponseTimeoutError, } from "./errors.js";
+/** Runs one browser step; a Playwright TimeoutError becomes a framework
+ * ResponseTimeoutError that names the step and keeps the original as cause. */
+export async function runStep(name, timeoutMs, fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === "TimeoutError") {
+            throw new ResponseTimeoutError(`Timed out during ${name} after ${timeoutMs} ms.`, { cause: err });
+        }
+        throw err;
+    }
+}
+/** One-shot flow: restore auth -> new chat -> send -> wait -> return text. */
+export async function runOneShot(opts) {
+    const { provider, authStore, onProgress, timeoutMs } = opts;
+    if (!authStore.has()) {
+        throw new AuthRequiredError(`No saved auth state for provider "${provider.name}". Run \`auth login\` first.`);
+    }
+    onProgress?.("Opening browser...");
+    const rt = await BrowserRuntime.launch({
+        headless: opts.headless,
+        provider,
+        authStore,
+    });
+    try {
+        rt.page.setDefaultTimeout(timeoutMs);
+        await runStep("goto", timeoutMs, () => rt.page.goto(provider.chatUrl));
+        const loggedIn = await runStep("isLoggedIn", timeoutMs, () => provider.isLoggedIn(rt.page));
+        if (!loggedIn) {
+            throw new AuthExpiredError(`Auth state for "${provider.name}" is no longer valid. Run \`auth login\` again.`);
+        }
+        await runStep("startNewChat", timeoutMs, () => provider.startNewChat(rt.page));
+        onProgress?.("Sending prompt...");
+        await runStep("sendMessage", timeoutMs, () => provider.sendMessage(rt.page, opts.prompt));
+        onProgress?.("Waiting for response...");
+        return await runStep("waitForResponse", timeoutMs, () => provider.waitForResponse(rt.page));
+    }
+    finally {
+        await rt.close();
+    }
+}
+const LOGIN_NAVIGATION_TIMEOUT_MS = 30_000;
+/** Headful login flow: the user logs in manually; we poll for completion. */
+export async function runLogin(opts) {
+    const { provider, authStore, onProgress } = opts;
+    onProgress?.("Opening browser...");
+    const rt = await BrowserRuntime.launch({
+        headless: false,
+        provider,
+        authStore,
+    });
+    try {
+        rt.page.setDefaultTimeout(LOGIN_NAVIGATION_TIMEOUT_MS);
+        await runStep("navigateToLogin", LOGIN_NAVIGATION_TIMEOUT_MS, () => provider.navigateToLogin(rt.page));
+        onProgress?.(`Please log in to ${provider.name}.`);
+        // Poll until the provider reports completion. No overall deadline:
+        // the user may need time for MFA; Ctrl-C aborts.
+        while (!(await provider.isLoggedIn(rt.page))) {
+            await rt.page.waitForTimeout(1000);
+        }
+        onProgress?.("✓ Login detected");
+        await rt.saveAuthState();
+        onProgress?.("✓ Session saved");
+    }
+    finally {
+        await rt.close();
+    }
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@chatbridge/core",
+  "version": "0.1.0",
+  "description": "Core session flows and errors for chatbridge",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/7milch/chatbridge-cli.git",
+    "directory": "packages/core"
+  },
+  "keywords": ["chatbridge", "playwright", "chat"],
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@chatbridge/provider": "0.1.0",
+    "@chatbridge/runtime": "0.1.0"
+  },
+  "devDependencies": {
+    "@chatbridge/example-dummy-chat": "0.0.0"
+  }
+}