@clinebot/shared 0.0.8

package/README.md

@@ -0,0 +1,48 @@
+# @clinebot/shared
+
+Package-level docs are centralized:
+
+- Overview: [`packages/README.md`](../README.md)
+- Architecture and interactions: [`ARCHITECTURE.md`](/Users/beatrix/dev/clinee/sdk-wip/ARCHITECTURE.md)
+
+`@clinebot/shared` owns shared cross-package primitives (session common types/utilities).
+
+Node-only filesystem path resolvers live under the storage subpath export:
+
+- `@clinebot/shared/storage`
+- examples: `resolveClineDataDir`, `resolveSessionDataDir`, `resolveTeamDataDir`
+
+It also exports cross-client logging contracts, including `BasicLogger`, so
+runtime, SDK, and host applications can share a single logger type.
+
+Session config primitives are also centralized here so hosts/runtimes can
+compose one base shape instead of redefining similar fields repeatedly:
+
+- `AgentMode`
+- `SessionPromptConfig`
+- `SessionWorkspaceConfig`
+- `SessionExecutionConfig` (includes canonical `ToolPolicy` map shape)
+
+It now also exports hook session context primitives used across agents/core/CLI:
+
+- `HookSessionContext`
+- `resolveHookSessionContext(...)`
+- `resolveRootSessionId(...)`
+- `resolveHookLogPath(...)`
+
+It also exports cross-client RPC runtime payload DTOs used by multiple hosts
+(`@clinebot/cli`, `@clinebot/code`) so request/response contracts are not duplicated
+outside transport wiring:
+
+- chat runtime payloads (`RpcChatStartSessionRequest`, `RpcChatRunTurnRequest`, `RpcChatTurnResult`)
+- provider runtime payloads (`RpcProviderActionRequest`, `RpcProviderCatalogResponse`, `RpcProviderOAuthLoginResponse`)
+- Cline account runtime payloads (`RpcClineAccountActionRequest`, `RpcClineAccountUser`, `RpcClineAccountBalance`)
+- provider action requests include provider catalog/model operations plus provider add/save operations for settings hosts
+- provider action payloads now expose granular request/type contracts for reuse:
+  `RpcAddProviderActionRequest`, `RpcSaveProviderSettingsActionRequest`,
+  `RpcProviderCapability`, and `RpcOAuthProviderId`
+
+Chat runtime payload notes:
+- `RpcChatStartSessionRequest` supports `initialMessages`, optional `toolPolicies`, optional `rules` for default system prompt assembly, and optional `logger` runtime config (`RpcChatRuntimeLoggerConfig`) so hosts can pass serialized logger settings to remote runtimes.
+- `RpcChatRuntimeLoggerConfig.bindings` lets hosts attach stable context fields (for example `clientId`, `clientType`, `clientApp`) to all runtime log records.
+- `RpcChatRunTurnRequest` supports `promptPreformatted` for callers that already built CLI-style user input envelopes.

package/dist/auth/constants.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Canonical list of OAuth provider IDs managed by the platform.
+ * Derive sets, types, and guards from this single source of truth.
+ */
+export declare const OAUTH_PROVIDER_IDS: readonly ["cline", "oca", "openai-codex"];
+export type OAuthProviderId = (typeof OAUTH_PROVIDER_IDS)[number];
+/**
+ * Check whether a provider ID is a managed OAuth provider.
+ */
+export declare function isOAuthProviderId(providerId: string): providerId is OAuthProviderId;
+/**
+ * Error‑message sub-strings that indicate an auth / credential failure.
+ * Used to decide whether a failed API call should trigger an OAuth refresh.
+ */
+export declare const AUTH_ERROR_PATTERNS: readonly ["401", "403", "unauthorized", "forbidden", "invalid token", "expired token", "authentication"];
+/**
+ * Returns `true` when `error` looks like an authentication failure
+ * *and* the provider is a managed OAuth provider.
+ */
+export declare function isLikelyAuthError(error: unknown, providerId: string): boolean;

package/dist/connectors/events.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+export declare const ConnectorHookEventNameSchema: z.ZodEnum<{
+    "connector.started": "connector.started";
+    "connector.stopping": "connector.stopping";
+    "message.received": "message.received";
+    "message.completed": "message.completed";
+    "message.failed": "message.failed";
+    "session.started": "session.started";
+    "session.reused": "session.reused";
+    "thread.reset": "thread.reset";
+    "schedule.delivery.started": "schedule.delivery.started";
+    "schedule.delivery.sent": "schedule.delivery.sent";
+    "schedule.delivery.failed": "schedule.delivery.failed";
+}>;
+export type ConnectorHookEventName = z.infer<typeof ConnectorHookEventNameSchema>;
+export declare const ConnectorHookEventSchema: z.ZodObject<{
+    adapter: z.ZodString;
+    botUserName: z.ZodOptional<z.ZodString>;
+    event: z.ZodEnum<{
+        "connector.started": "connector.started";
+        "connector.stopping": "connector.stopping";
+        "message.received": "message.received";
+        "message.completed": "message.completed";
+        "message.failed": "message.failed";
+        "session.started": "session.started";
+        "session.reused": "session.reused";
+        "thread.reset": "thread.reset";
+        "schedule.delivery.started": "schedule.delivery.started";
+        "schedule.delivery.sent": "schedule.delivery.sent";
+        "schedule.delivery.failed": "schedule.delivery.failed";
+    }>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    ts: z.ZodString;
+}, z.core.$strip>;
+export type ConnectorHookEvent = z.infer<typeof ConnectorHookEventSchema>;

package/dist/db/index.d.ts

@@ -0,0 +1,2 @@
+export type { SessionSchemaOptions, SqliteDb, SqliteStatement, } from "./sqlite-db";
+export { asBool, asOptionalString, asString, ensureSessionSchema, loadSqliteDb, nowIso, toBoolInt, } from "./sqlite-db";

package/dist/db/index.js

@@ -0,0 +1,92 @@
+var D=Object.defineProperty;var E=(S)=>S;function F(S,g){this[S]=E.bind(null,g)}var W=(S,g)=>{for(var w in g)D(S,w,{get:g[w],enumerable:!0,configurable:!0,set:F.bind(g,w)})};import{createRequire as G}from"node:module";function J(){return new Date().toISOString()}function K(S){return S?1:0}function L(S){return typeof S==="string"?S:""}function Q(S){if(typeof S!=="string")return;let g=S.trim();return g.length>0?g:void 0}function T(S){return S===1||S===!0}function U(S){let g=G(import.meta.url);if(typeof globalThis.Bun<"u"){let{Database:j}=g("bun:sqlite"),x=new j(S,{create:!0});return{prepare:(I)=>{let k=x.query(I);return{run:(...O)=>k.run(...O),get:(...O)=>k.get(...O),all:(...O)=>k.all(...O)}},exec:(I)=>x.exec(I)}}try{let j=["node",":sqlite"].join(""),{DatabaseSync:x}=g(j),I=new x(S);return{prepare:(k)=>{let O=I.prepare(k);return{run:(...z)=>O.run(...z),get:(...z)=>O.get(...z)??null,all:(...z)=>O.all(...z)}},exec:(k)=>I.exec(k)}}catch{}let B=["better","-sqlite3"].join("");return new(g(B))(S)}function V(S,g={}){if(S.exec("PRAGMA journal_mode = WAL;"),S.exec("PRAGMA busy_timeout = 5000;"),S.exec(`
+		CREATE TABLE IF NOT EXISTS sessions (
+			session_id TEXT PRIMARY KEY,
+			source TEXT NOT NULL,
+			pid INTEGER NOT NULL,
+			started_at TEXT NOT NULL,
+			ended_at TEXT,
+			exit_code INTEGER,
+			status TEXT NOT NULL,
+			status_lock INTEGER NOT NULL DEFAULT 0,
+			interactive INTEGER NOT NULL,
+			provider TEXT NOT NULL,
+			model TEXT NOT NULL,
+			cwd TEXT NOT NULL,
+			workspace_root TEXT NOT NULL,
+			team_name TEXT,
+			enable_tools INTEGER NOT NULL,
+			enable_spawn INTEGER NOT NULL,
+			enable_teams INTEGER NOT NULL,
+			parent_session_id TEXT,
+			parent_agent_id TEXT,
+			agent_id TEXT,
+			conversation_id TEXT,
+			is_subagent INTEGER NOT NULL DEFAULT 0,
+			prompt TEXT,
+			metadata_json TEXT,
+			transcript_path TEXT NOT NULL,
+			hook_path TEXT NOT NULL,
+			messages_path TEXT,
+			updated_at TEXT NOT NULL
+		);
+	`),S.exec(`
+		CREATE TABLE IF NOT EXISTS subagent_spawn_queue (
+			id INTEGER PRIMARY KEY AUTOINCREMENT,
+			root_session_id TEXT NOT NULL,
+			parent_agent_id TEXT NOT NULL,
+			task TEXT,
+			system_prompt TEXT,
+			created_at TEXT NOT NULL,
+			consumed_at TEXT
+		);
+	`),S.exec(`
+		CREATE TABLE IF NOT EXISTS schedules (
+			schedule_id TEXT PRIMARY KEY,
+			name TEXT NOT NULL,
+			cron_pattern TEXT NOT NULL,
+			prompt TEXT NOT NULL,
+			provider TEXT NOT NULL,
+			model TEXT NOT NULL,
+			mode TEXT NOT NULL DEFAULT 'act',
+			workspace_root TEXT,
+			cwd TEXT,
+			system_prompt TEXT,
+			max_iterations INTEGER,
+			timeout_seconds INTEGER,
+			max_parallel INTEGER NOT NULL DEFAULT 1,
+			enabled INTEGER NOT NULL DEFAULT 1,
+			created_at TEXT NOT NULL,
+			updated_at TEXT NOT NULL,
+			last_run_at TEXT,
+			next_run_at TEXT,
+			claim_token TEXT,
+			claim_started_at TEXT,
+			claim_until_at TEXT,
+			created_by TEXT,
+			tags TEXT,
+			metadata_json TEXT
+		);
+	`),S.exec(`
+		CREATE TABLE IF NOT EXISTS schedule_executions (
+			execution_id TEXT PRIMARY KEY,
+			schedule_id TEXT NOT NULL,
+			session_id TEXT,
+			triggered_at TEXT NOT NULL,
+			started_at TEXT,
+			ended_at TEXT,
+			status TEXT NOT NULL,
+			exit_code INTEGER,
+			error_message TEXT,
+			iterations INTEGER,
+			tokens_used INTEGER,
+			cost_usd REAL,
+			FOREIGN KEY (schedule_id) REFERENCES schedules(schedule_id) ON DELETE CASCADE,
+			FOREIGN KEY (session_id) REFERENCES sessions(session_id) ON DELETE SET NULL
+		);
+	`),S.exec(`
+		CREATE INDEX IF NOT EXISTS idx_schedule_executions_schedule
+		ON schedule_executions(schedule_id, triggered_at DESC);
+	`),S.exec(`
+		CREATE INDEX IF NOT EXISTS idx_schedules_next_run
+		ON schedules(enabled, next_run_at);
+	`),!g.includeLegacyMigrations)return;let w=S.prepare("PRAGMA table_info(sessions);").all(),B=(x)=>w.some((I)=>I.name===x);if(!B("workspace_root"))S.exec("ALTER TABLE sessions ADD COLUMN workspace_root TEXT;"),S.exec("UPDATE sessions SET workspace_root = cwd WHERE workspace_root IS NULL OR workspace_root = '';");if(!B("parent_session_id"))S.exec("ALTER TABLE sessions ADD COLUMN parent_session_id TEXT;");if(!B("parent_agent_id"))S.exec("ALTER TABLE sessions ADD COLUMN parent_agent_id TEXT;");if(!B("agent_id"))S.exec("ALTER TABLE sessions ADD COLUMN agent_id TEXT;");if(!B("conversation_id"))S.exec("ALTER TABLE sessions ADD COLUMN conversation_id TEXT;");if(!B("is_subagent"))S.exec("ALTER TABLE sessions ADD COLUMN is_subagent INTEGER NOT NULL DEFAULT 0;");if(!B("messages_path"))S.exec("ALTER TABLE sessions ADD COLUMN messages_path TEXT;");if(!B("metadata_json"))S.exec("ALTER TABLE sessions ADD COLUMN metadata_json TEXT;");let A=S.prepare("PRAGMA table_info(schedules);").all(),j=(x)=>A.some((I)=>I.name===x);if(!j("claim_token"))S.exec("ALTER TABLE schedules ADD COLUMN claim_token TEXT;");if(!j("claim_started_at"))S.exec("ALTER TABLE schedules ADD COLUMN claim_started_at TEXT;");if(!j("claim_until_at"))S.exec("ALTER TABLE schedules ADD COLUMN claim_until_at TEXT;")}export{K as toBoolInt,J as nowIso,U as loadSqliteDb,V as ensureSessionSchema,L as asString,Q as asOptionalString,T as asBool};

package/dist/db/sqlite-db.d.ts

@@ -0,0 +1,21 @@
+export type SqliteStatement = {
+    run: (...params: unknown[]) => {
+        changes?: number;
+    };
+    get: (...params: unknown[]) => Record<string, unknown> | null;
+    all: (...params: unknown[]) => Record<string, unknown>[];
+};
+export type SqliteDb = {
+    prepare: (sql: string) => SqliteStatement;
+    exec: (sql: string) => void;
+};
+export declare function nowIso(): string;
+export declare function toBoolInt(value: boolean): number;
+export declare function asString(value: unknown): string;
+export declare function asOptionalString(value: unknown): string | undefined;
+export declare function asBool(value: unknown): boolean;
+export declare function loadSqliteDb(filePath: string): SqliteDb;
+export interface SessionSchemaOptions {
+    includeLegacyMigrations?: boolean;
+}
+export declare function ensureSessionSchema(db: SqliteDb, options?: SessionSchemaOptions): void;

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export type { OAuthProviderId } from "./auth/constants";
+export { AUTH_ERROR_PATTERNS, isLikelyAuthError, isOAuthProviderId, OAUTH_PROVIDER_IDS, } from "./auth/constants";
+export type { ConnectorHookEvent, ConnectorHookEventName, } from "./connectors/events";
+export { ConnectorHookEventNameSchema, ConnectorHookEventSchema, } from "./connectors/events";
+export { MODELS_DEV_PROVIDER_KEY_ENTRIES, MODELS_DEV_PROVIDER_KEY_MAP, resolveProviderModelCatalogKeys, } from "./llms/model-id";
+export type { Tool, ToolApprovalRequest, ToolApprovalResult, ToolCallRecord, ToolContext, ToolPolicy, } from "./llms/tools";
+export { ToolCallRecordSchema, ToolContextSchema } from "./llms/tools";
+export type { BasicLogger } from "./logging/logger";
+export { parseJsonStream, safeJsonStringify } from "./parse/json";
+export { formatHumanReadableDate } from "./parse/time";
+export { validateWithZod, zodToJsonSchema } from "./parse/zod";
+export { formatFileContentBlock, formatUserInputBlock, normalizeUserInput, xmlTagsRemoval, } from "./prompt/format";
+export type { RpcAddProviderActionRequest, RpcAgentMode, RpcChatAttachmentFile, RpcChatAttachments, RpcChatMessage, RpcChatRunTurnRequest, RpcChatRuntimeConfigBase, RpcChatRuntimeLoggerConfig, RpcChatStartSessionArtifacts, RpcChatStartSessionRequest, RpcChatStartSessionResponse, RpcChatToolCallResult, RpcChatTurnResult, RpcClineAccountActionRequest, RpcClineAccountBalance, RpcClineAccountOrganization, RpcClineAccountOrganizationBalance, RpcClineAccountOrganizationUsageTransaction, RpcClineAccountPaymentTransaction, RpcClineAccountUsageTransaction, RpcClineAccountUser, RpcGetProviderModelsActionRequest, RpcListProvidersActionRequest, RpcOAuthProviderId, RpcProviderActionRequest, RpcProviderCapability, RpcProviderCatalogResponse, RpcProviderListItem, RpcProviderModel, RpcProviderModelsResponse, RpcProviderOAuthLoginResponse, RpcProviderSettingsActionRequest, RpcSaveProviderSettingsActionRequest, RpcSessionStorageOptions, } from "./rpc/runtime";
+export type { TeamProgressCounts, TeamProgressLifecycleEvent, TeamProgressMemberRole, TeamProgressMemberStatus, TeamProgressOutcomeFragmentStatus, TeamProgressOutcomeStatus, TeamProgressProjectionEvent, TeamProgressRunStatus, TeamProgressSummary, TeamProgressTaskStatus, } from "./rpc/team-progress";
+export { RPC_TEAM_LIFECYCLE_EVENT_TYPE, RPC_TEAM_PROGRESS_EVENT_TYPE, } from "./rpc/team-progress";
+export type { ITelemetryService, OpenTelemetryClientConfig, TelemetryArray, TelemetryMetadata, TelemetryObject, TelemetryPrimitive, TelemetryProperties, TelemetryValue, } from "./services/telemetry";
+export type { ClineTelemetryServiceConfig } from "./services/telemetry-config";
+export { createClineTelemetryServiceConfig, createClineTelemetryServiceMetadata, } from "./services/telemetry-config";
+export type { HookSessionContext, HookSessionContextLookup, HookSessionContextProvider, } from "./session/hook-context";
+export { resolveHookLogPath, resolveHookSessionContext, resolveRootSessionId, } from "./session/hook-context";
+export type { SessionLineage, SessionRuntimeRecordShape, SharedSessionStatus, } from "./session/records";
+export { SESSION_STATUS_VALUES } from "./session/records";
+export type { AgentMode, SessionExecutionConfig, SessionPromptConfig, SessionWorkspaceConfig, } from "./session/runtime-config";
+export type { RuntimeEnv } from "./session/runtime-env";
+export type { VcrRecording } from "./vcr";
+export { initVcr } from "./vcr";