@sctg/cline-shared 3.84.0-beta.20260524130712

package/dist/team/types.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Team data types and interfaces.
+ *
+ * These are the pure data-shape contracts for the multi-agent team system.
+ * They intentionally avoid referencing @cline/agents types so that shared
+ * can remain dependency-free of the agents package.
+ */
+export type TeamTaskStatus = "pending" | "in_progress" | "blocked" | "completed";
+export interface TeamTask {
+    id: string;
+    title: string;
+    description: string;
+    status: TeamTaskStatus;
+    createdAt: Date;
+    updatedAt: Date;
+    createdBy: string;
+    assignee?: string;
+    dependsOn: string[];
+    summary?: string;
+}
+export interface TeamTaskListItem extends TeamTask {
+    isReady: boolean;
+    blockedBy: string[];
+}
+export type MissionLogKind = "progress" | "handoff" | "blocked" | "decision" | "done" | "error";
+export interface MissionLogEntry {
+    id: string;
+    ts: Date;
+    teamId: string;
+    agentId: string;
+    taskId?: string;
+    kind: MissionLogKind;
+    summary: string;
+    evidence?: string[];
+    nextAction?: string;
+}
+export interface TeamMailboxMessage {
+    id: string;
+    teamId: string;
+    fromAgentId: string;
+    toAgentId: string;
+    subject: string;
+    body: string;
+    taskId?: string;
+    sentAt: Date;
+    readAt?: Date;
+}
+export interface TeamMemberSnapshot {
+    agentId: string;
+    role: "lead" | "teammate";
+    description?: string;
+    status: "idle" | "running" | "stopped";
+}
+export interface TeammateLifecycleSpec {
+    rolePrompt: string;
+    modelId?: string;
+    maxIterations?: number;
+    runtimeAgentId?: string;
+    conversationId?: string;
+    parentAgentId?: string | null;
+}
+export type TeamRunStatus = "queued" | "running" | "completed" | "failed" | "cancelled" | "interrupted";
+/**
+ * Shared representation of a teammate run record.
+ *
+ * The `result` field is typed as `unknown` at the shared contract level
+ * because the concrete type (`AgentResult`) lives in `@cline/agents`.
+ * Consuming packages narrow this via their own type assertions.
+ */
+export interface TeamRunRecord {
+    id: string;
+    agentId: string;
+    taskId?: string;
+    status: TeamRunStatus;
+    message: string;
+    priority: number;
+    retryCount: number;
+    maxRetries: number;
+    nextAttemptAt?: Date;
+    continueConversation?: boolean;
+    startedAt: Date;
+    endedAt?: Date;
+    leaseOwner?: string;
+    heartbeatAt?: Date;
+    lastProgressAt?: Date;
+    lastProgressMessage?: string;
+    currentActivity?: string;
+    result?: unknown;
+    error?: string;
+}
+export type TeamOutcomeStatus = "draft" | "in_review" | "finalized";
+export interface TeamOutcome {
+    id: string;
+    teamId: string;
+    title: string;
+    status: TeamOutcomeStatus;
+    requiredSections: string[];
+    createdBy: string;
+    createdAt: Date;
+    finalizedAt?: Date;
+}
+export type TeamOutcomeFragmentStatus = "draft" | "reviewed" | "rejected";
+export interface TeamOutcomeFragment {
+    id: string;
+    teamId: string;
+    outcomeId: string;
+    section: string;
+    sourceAgentId: string;
+    sourceRunId?: string;
+    content: string;
+    status: TeamOutcomeFragmentStatus;
+    reviewedBy?: string;
+    reviewedAt?: Date;
+    createdAt: Date;
+}
+export interface TeamRuntimeSnapshot {
+    teamId: string;
+    teamName: string;
+    members: TeamMemberSnapshot[];
+    taskCounts: Record<TeamTaskStatus, number>;
+    unreadMessages: number;
+    missionLogEntries: number;
+    activeRuns: number;
+    queuedRuns: number;
+    outcomeCounts: Record<TeamOutcomeStatus, number>;
+}
+export interface TeamRuntimeState {
+    teamId: string;
+    teamName: string;
+    members: TeamMemberSnapshot[];
+    tasks: TeamTask[];
+    mailbox: TeamMailboxMessage[];
+    missionLog: MissionLogEntry[];
+    runs: TeamRunRecord[];
+    outcomes: TeamOutcome[];
+    outcomeFragments: TeamOutcomeFragment[];
+}
+export interface AppendMissionLogInput {
+    agentId: string;
+    taskId?: string;
+    kind: MissionLogKind;
+    summary: string;
+    evidence?: string[];
+    nextAction?: string;
+}
+export interface CreateTeamTaskInput {
+    title: string;
+    description: string;
+    createdBy: string;
+    dependsOn?: string[];
+    assignee?: string;
+}
+export interface CreateTeamOutcomeInput {
+    title: string;
+    requiredSections: string[];
+    createdBy: string;
+}
+export interface AttachTeamOutcomeFragmentInput {
+    outcomeId: string;
+    section: string;
+    sourceAgentId: string;
+    sourceRunId?: string;
+    content: string;
+}
+export interface ReviewTeamOutcomeFragmentInput {
+    fragmentId: string;
+    reviewedBy: string;
+    approved: boolean;
+}
+export interface RouteToTeammateOptions {
+    taskId?: string;
+    fromAgentId?: string;
+    continueConversation?: boolean;
+}
+export declare enum TeamMessageType {
+    TaskStart = "task_start",
+    TaskEnd = "task_end",
+    AgentEvent = "agent_event",
+    TeammateSpawned = "teammate_spawned",
+    TeammateShutdown = "teammate_shutdown",
+    TeamTaskUpdated = "team_task_updated",
+    TeamMessage = "team_message",
+    TeamMissionLog = "team_mission_log",
+    TeamTaskCompleted = "team_task_completed",
+    RunStarted = "run_started",
+    RunQueued = "run_queued",
+    RunProgress = "run_progress",
+    RunCompleted = "run_completed",
+    RunFailed = "run_failed",
+    RunCancelled = "run_cancelled",
+    RunInterrupted = "run_interrupted",
+    OutcomeCreated = "outcome_created",
+    OutcomeFragmentAttached = "outcome_fragment_attached",
+    OutcomeFragmentReviewed = "outcome_fragment_reviewed",
+    OutcomeFinalized = "outcome_finalized"
+}

package/dist/tools/create.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import type { AgentTool, AgentToolContext } from "../agent";
+export declare function createTool<TInput, TOutput>(config: {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    execute: (input: TInput, context: AgentToolContext) => Promise<TOutput>;
+    lifecycle?: AgentTool<TInput, TOutput>["lifecycle"];
+    timeoutMs?: number;
+    retryable?: boolean;
+    maxRetries?: number;
+}): AgentTool<TInput, TOutput>;
+export declare function createTool<TSchema extends z.ZodTypeAny, TOutput>(config: {
+    name: string;
+    description: string;
+    inputSchema: TSchema;
+    execute: (input: z.infer<TSchema>, context: AgentToolContext) => Promise<TOutput>;
+    lifecycle?: AgentTool<z.infer<TSchema>, TOutput>["lifecycle"];
+    timeoutMs?: number;
+    retryable?: boolean;
+    maxRetries?: number;
+}): AgentTool<z.infer<TSchema>, TOutput>;

package/dist/types/auth.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/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./auth";
+export * from "./vcr";

package/dist/types/vcr.d.ts

@@ -0,0 +1,14 @@
+/** A single recorded HTTP interaction. */
+export interface VcrRecording {
+    scope: string;
+    method: string;
+    path: string;
+    body?: string;
+    /** Sanitized canonical request body used as an optional playback contract. */
+    requestBody?: string;
+    status: number;
+    response: unknown;
+    responseIsBinary: boolean;
+    /** Content-Type header from the original response (captured at record time). */
+    contentType?: string;
+}

package/dist/vcr.d.ts

@@ -0,0 +1,41 @@
+/**
+ * VCR (Video Cassette Recorder) for HTTP requests.
+ *
+ * Patches `globalThis.fetch` to record and replay HTTP interactions,
+ * enabling deterministic testing without making real API calls.
+ *
+ * Unlike nock (which patches Node's `http` module), this works by wrapping
+ * `globalThis.fetch` directly, catching all HTTP traffic in this codebase
+ * including calls made through the OpenAI, Anthropic, Gemini, and Vercel AI
+ * SDKs (all of which delegate to the global fetch).
+ *
+ * Environment variables:
+ *   CLINE_VCR           - "record" to record HTTP requests, "playback" to replay them
+ *   CLINE_VCR_CASSETTE  - Path to the cassette file (default: ./vcr-cassette.json)
+ *   CLINE_VCR_FILTER    - Substring to filter recorded/replayed request paths.
+ *                         When set to a non-empty string, only requests whose path
+ *                         contains this substring are recorded/replayed; all other
+ *                         requests pass through to the real network.
+ *                         When empty or unset, ALL requests are intercepted (no filter).
+ *   CLINE_VCR_INCLUDE_REQUEST_BODY - "1" to save sanitized request bodies and
+ *                         assert them during playback.
+ *   CLINE_VCR_SSE_DELAY - Milliseconds between SSE chunks during playback (default: 100).
+ *                         Set to 0 for instant delivery.
+ *
+ * Usage:
+ *   # Record only inference requests
+ *   CLINE_VCR=record CLINE_VCR_CASSETTE=./fixtures/my-test.json cline task "hello"
+ *
+ *   # Replay: auth/S3/etc. requests go through normally, only inference is mocked
+ *   CLINE_VCR=playback CLINE_VCR_CASSETTE=./fixtures/my-test.json cline task "hello"
+ *
+ *   # Record everything (no filter)
+ *   CLINE_VCR=record CLINE_VCR_FILTER="" CLINE_VCR_CASSETTE=./fixtures/all.json cline task "hello"
+ */
+/**
+ * Initialize VCR mode based on environment variables.
+ * Must be called early in startup, before HTTP requests are made.
+ *
+ * Does nothing if `CLINE_VCR` is not set.
+ */
+export declare function initVcr(vcrMode: string | undefined): void;

package/package.json

@@ -0,0 +1,63 @@
+{
+	"name": "@sctg/cline-shared",
+	"version": "3.84.0-beta.20260524130712",
+	"description": "Shared utilities, types, and schemas for Cline packages",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/cline/cline",
+		"directory": "sdk/packages/shared"
+	},
+	"type": "module",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"browser": "./dist/index.browser.js",
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		},
+		"./browser": {
+			"types": "./dist/index.browser.d.ts",
+			"import": "./dist/index.browser.js"
+		},
+		"./types": {
+			"types": "./dist/types/index.d.ts",
+			"import": "./dist/types/index.js"
+		},
+		"./storage": {
+			"types": "./dist/storage/index.d.ts",
+			"import": "./dist/storage/index.js"
+		},
+		"./db": {
+			"types": "./dist/db/index.d.ts",
+			"import": "./dist/db/index.js"
+		},
+		"./automation": {
+			"types": "./dist/automation/index.d.ts",
+			"import": "./dist/automation/index.js"
+		},
+		"./remote-config": {
+			"types": "./dist/remote-config/index.d.ts",
+			"import": "./dist/remote-config/index.js"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "BUILD_MODE=package bun bun.mts",
+		"typecheck": "bun tsc --noEmit",
+		"test": "bun run test:unit",
+		"test:unit": "vitest run --config vitest.config.ts"
+	},
+	"engines": {
+		"node": ">=22"
+	},
+	"dependencies": {
+		"aws4fetch": "^1.0.20",
+		"jsonrepair": "^3.13.2",
+		"zod": "^4.3.6",
+		"zod-to-json-schema": "^3.25.1"
+	}
+}