codna 0.1.0__py3-none-any.whl

codna/agent-core/vendor/cline/sdk/packages/agents/src/index.ts

@@ -0,0 +1,57 @@
+/**
+ * @cline/agents
+ *
+ * Browser-safe agent runtime for the next-generation Cline SDK.
+ *
+ * Exports:
+ *   - `AgentRuntime` / `Agent` — the agentic loop class (two names for the
+ *     same class). Use `Agent` when supplying provider/model IDs, or
+ *     `AgentRuntime` when supplying a pre-built `AgentModel`.
+ *   - `createAgentRuntime` / `createAgent` — factory-function equivalents.
+ *   - `AgentRuntimeConfig` and its two variants (`AgentRuntimeConfigWithModel`,
+ *     `AgentRuntimeConfigWithProvider`) — the discriminated config union.
+ *   - `AgentRunInput` / `AgentEventListener` — convenience type aliases.
+ *   - `createTool` — re-exported from `@cline/shared` for authoring tools.
+ *
+ * Shared types (`AgentMessage`, `AgentRunResult`, etc.) should be imported
+ * directly from `@cline/shared`.
+ */
+
+export type {
+	AgentAfterToolResult,
+	AgentBeforeModelResult,
+	AgentBeforeToolResult,
+	AgentMessage,
+	AgentMessagePart,
+	AgentModel,
+	AgentModelFinishReason,
+	AgentModelRequest,
+	AgentRunResult,
+	AgentRuntimeConfig as BaseAgentRuntimeConfig,
+	AgentRuntimeEvent,
+	AgentRuntimeHooks,
+	AgentRuntimeStateSnapshot,
+	AgentStopControl,
+	AgentTool,
+	AgentToolCallPart,
+	AgentToolDefinition,
+	AgentToolResult,
+	AgentUsage,
+	ToolApprovalResult,
+	ToolPolicy,
+} from "@cline/shared";
+export { createTool } from "@cline/shared";
+export type {
+	AgentEventListener,
+	AgentRunInput,
+	AgentRuntimeConfig,
+	AgentRuntimeConfigWithModel,
+	AgentRuntimeConfigWithProvider,
+} from "./agent-runtime";
+export {
+	Agent,
+	AgentRuntime,
+	AgentRuntimeAbortError,
+	createAgent,
+	createAgentRuntime,
+} from "./agent-runtime";

codna/agent-core/vendor/cline/sdk/packages/agents/tsconfig.build.json

@@ -0,0 +1,13 @@
+{
+	"extends": "./tsconfig.json",
+	"compilerOptions": {
+		"declaration": true,
+		"declarationMap": true,
+		"sourceMap": false,
+		"emitDeclarationOnly": true,
+		"outDir": "./dist",
+		"rootDir": "./src",
+		"incremental": false
+	},
+	"include": ["src/index.ts"]
+}

codna/agent-core/vendor/cline/sdk/packages/agents/tsconfig.dev.json

@@ -0,0 +1,13 @@
+{
+	"extends": "./tsconfig.json",
+	"compilerOptions": {
+		"baseUrl": ".",
+		"rootDir": "..",
+		"noUnusedLocals": false,
+		"noUnusedParameters": false,
+		"paths": {
+			"@cline/shared": ["../shared/src/index.ts"],
+			"@cline/shared/*": ["../shared/src/*", "../shared/src/*/index.ts"]
+		}
+	}
+}

codna/agent-core/vendor/cline/sdk/packages/agents/tsconfig.json

@@ -0,0 +1,9 @@
+{
+	"extends": "../tsconfig.base.json",
+	"compilerOptions": {
+		"outDir": "./dist",
+		"rootDir": "./src"
+	},
+	"include": ["src/**/*"],
+	"exclude": ["node_modules", "dist", "**/*.test.ts", "**/__tests__/**"]
+}

codna/agent-core/vendor/cline/sdk/packages/agents/vitest.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+	test: {
+		environment: "node",
+		include: ["src/**/*.test.ts"],
+		exclude: ["src/example.test.ts"],
+		passWithNoTests: true,
+	},
+});

codna/agent-core/vendor/cline/sdk/packages/core/README.md

@@ -0,0 +1,110 @@
+# [experimental] @cline/core
+
+`@cline/core` is the stateful orchestration layer of the Cline SDK. It
+connects the agent runtime, provider settings, storage, default tools, and
+session lifecycle into a host-ready runtime.
+
+## What You Get
+
+- session lifecycle and orchestration primitives
+- provider settings and account services
+- default runtime tools and MCP integration
+- storage-backed session and team state helpers
+- host-facing Node helpers through `@cline/core`
+
+## Installation
+
+```bash
+npm install @cline/core
+```
+
+## Entry Points
+
+- `@cline/core`: core contracts, shared utilities, and Node/server helpers for building hosts and runtimes
+
+## Typical Usage
+
+Most host apps should start with `@cline/core`.
+
+```ts
+import { ClineCore } from "@cline/core";
+
+const cline = await ClineCore.create({});
+
+const result = await cline.start({
+	config: {
+		providerId: "anthropic",
+		modelId: "claude-sonnet-4-6",
+		apiKey: process.env.ANTHROPIC_API_KEY ?? "",
+		cwd: process.cwd(),
+		mode: "act",
+		enableTools: true,
+		enableSpawnAgent: false,
+		enableAgentTeams: false,
+		systemPrompt: "You are a concise assistant.",
+	},
+	prompt: "Summarize this project.",
+	interactive: false,
+});
+
+console.log(result.result?.text);
+await cline.dispose();
+```
+
+## Session Bootstrap
+
+`ClineCore.create(...)` also accepts `prepare(input)`.
+
+Use it when a host needs to prepare workspace-scoped runtime state before each
+session starts, then apply watcher/extensions/telemetry inputs through
+explicit `localRuntime` bootstrap fields without widening the shared host
+contract.
+
+## Main APIs
+
+### Runtime and Sessions
+
+Use `@cline/core` for host-facing runtime assembly:
+
+- `ClineCore.create(...)`
+- `createRuntimeHost(...)`
+- `LocalRuntimeHost`
+- `HubRuntimeHost` and `RemoteRuntimeHost`
+- `DefaultRuntimeBuilder`
+
+`ClineCore` is the app-facing session API. The lower-level `RuntimeHost`
+boundary uses runtime-primitive names such as `startSession` and `runTurn` so
+transport adapters stay distinct from product methods like `start` and `send`.
+Service-style operations such as pending prompt edits, accumulated usage lookup,
+and active-session model switching are exposed through `ClineCore` when the
+selected transport supports them rather than being part of the minimal host
+primitive vocabulary.
+
+### Default Tools
+
+`@cline/core` owns the built-in host tools and executors:
+
+- `createBuiltinTools(...)`
+- `createDefaultTools(...)`
+- `createDefaultExecutors(...)`
+
+### Storage and Settings
+
+The package also exports storage and settings helpers such as:
+
+- `ProviderSettingsManager`
+- `CoreSettingsService` and `createCoreSettingsService`
+- MCP settings helpers such as `setMcpServerDisabled`
+- `SqliteTeamStore`
+- SQLite-backed local session stores and artifacts through `@cline/core`
+
+## Related Packages
+
+- `@cline/agents`: stateless agent loop and tool primitives
+- `@cline/llms`: provider/model configuration and handlers
+
+## More Examples
+
+- Repo examples: [examples](https://github.com/cline/sdk/tree/main/examples), [apps/examples](https://github.com/cline/sdk/tree/main/apps/examples)
+- Workspace overview: [README.md](https://github.com/cline/cline/blob/main/README.md)
+- API and architecture references: [DOC.md](https://github.com/cline/cline/blob/main/DOC.md), [ARCHITECTURE.md](https://github.com/cline/cline/blob/main/ARCHITECTURE.md)

codna/agent-core/vendor/cline/sdk/packages/core/bun.mts

@@ -0,0 +1,75 @@
+/// <reference types="@types/bun" />
+export {};
+
+type PackageManifest = {
+	dependencies?: Record<string, string>;
+	peerDependencies?: Record<string, string>;
+};
+
+const packageJson = (await Bun.file(
+	new URL("./package.json", import.meta.url),
+).json()) as PackageManifest;
+
+// Keep declared runtime packages external so they are not duplicated inside each
+// bundled entrypoint and installed again from package.json.
+const external = Object.keys({
+	...(packageJson.dependencies ?? {}),
+	...(packageJson.peerDependencies ?? {}),
+});
+
+const sourcemap = Bun.env.CLINE_SOURCEMAPS === "1" ? "linked" : "none";
+
+const buildConfig = {
+	target: "node",
+	format: "esm",
+	minify: true,
+	packages: "bundle",
+	sourcemap,
+	external,
+} as const;
+
+const builds: Parameters<typeof Bun.build>[0][] = [
+	// Build main exports separately to avoid Bun bundler output path conflicts
+	{
+		entrypoints: ["./src/index.ts"],
+		outdir: "./dist",
+		...buildConfig,
+	},
+	{
+		entrypoints: ["./src/hub/index.ts"],
+		outdir: "./dist/hub",
+		...buildConfig,
+	},
+	{
+		entrypoints: ["./src/hub/daemon/entry.ts"],
+		outdir: "./dist/hub/daemon",
+		...buildConfig,
+	},
+	{
+		entrypoints: ["./src/services/telemetry/index.ts"],
+		outdir: "./dist/services/telemetry",
+		...buildConfig,
+	},
+	// The plugin sandbox bootstrap runs in an isolated child process via
+	// SubprocessSandbox and must be emitted as a separate executable entrypoint.
+	{
+		entrypoints: ["./src/extensions/plugin/plugin-sandbox-bootstrap.ts"],
+		outdir: "./dist/extensions",
+		...buildConfig,
+	},
+];
+
+for (const config of builds) {
+	const result = await Bun.build(config as Parameters<typeof Bun.build>[0]);
+
+	if (!result.success) {
+		console.error("Build failed for entrypoints:", config.entrypoints);
+		process.exit(1);
+	}
+
+	if (result.logs.length > 0) {
+		for (const log of result.logs) {
+			console.warn(log);
+		}
+	}
+}

codna/agent-core/vendor/cline/sdk/packages/core/docs/messages-contract-v1.md

@@ -0,0 +1,148 @@
+# messages.json contract — v1
+
+This document describes the persisted session messages artifact written by
+`@cline/core` at:
+
+```
+~/.cline/data/sessions/<sessionId>/<sessionId>.messages.json
+```
+
+It is the canonical replay/export artifact. Downstream consumers (for example,
+ATIF converters) should be able to reconstruct a full session trajectory from
+this file alone. `hooks.jsonl` in the same directory is observability/debug
+telemetry and is not required for replay or export.
+
+The schema is versioned by the top-level `version` field. This document
+describes **version `1`**.
+
+## File-level shape
+
+```jsonc
+{
+  "version": 1,
+  "updated_at": "2026-04-22T17:42:10.123Z",
+  "agent": "lead" | "subagent" | "teammate",
+  "sessionId": "<session-id>",
+  "taskType": "...",              // optional; present for subagent/team runs
+  "messages": [ /* see below */ ],
+  "system_prompt": "..."          // optional
+}
+```
+
+Producer: [`buildMessagesFilePayload`](../src/services/session-data.ts).
+
+## Message shape
+
+Each entry in `messages[]` is a normalized stored message:
+
+```jsonc
+{
+  "id": "<stable-nanoid>",             // always present; generated if missing
+  "role": "user" | "assistant",
+  "content": [ /* content blocks, see below */ ],
+  "ts": 1745343730123,                 // epoch ms; present on assistant turn messages
+  "modelInfo": {                       // assistant only; see assistant guarantees
+    "id": "claude-sonnet-4-6",
+    "provider": "anthropic",
+    "family": "claude-sonnet-4"        // optional
+  },
+  "metrics": {                         // terminal assistant message of a turn; see below
+    "inputTokens": 21,
+    "outputTokens": 8,
+    "cacheReadTokens": 3,
+    "cacheWriteTokens": 1,
+    "cost": 0.13
+  }
+}
+```
+
+Notes:
+
+- `role` is `"user"` or `"assistant"`. There is no distinct `"tool"` role at
+  rest — tool results are embedded as `tool_result` blocks on a `user` message
+  (Anthropic-native shape).
+- `content` is always an array. No string-form content.
+
+## Content block shape (Anthropic-native)
+
+The persisted content uses the provider-native block shape, not the gateway
+kebab-case shape. Valid block `type` values:
+
+| `type`        | Fields                                                | Role      |
+|---------------|-------------------------------------------------------|-----------|
+| `text`        | `text: string`                                        | any       |
+| `thinking`    | `thinking: string` (reasoning text)                   | assistant |
+| `tool_use`    | `id: string`, `name: string`, `input: unknown`        | assistant |
+| `tool_result` | `tool_use_id: string`, `content: unknown`, `is_error?: boolean` | user |
+
+Correlation: a `tool_result.tool_use_id` matches a prior
+`tool_use.id` on an assistant message. IDs are stable within the session.
+
+Error signal on tool results: `is_error` is the single canonical field.
+When set by the provider path it is normalized to boolean (`false` by default).
+
+## Assistant turn guarantees
+
+For each **completed** assistant turn (one the model actually produced output
+for), the terminal assistant message of that turn carries:
+
+- `modelInfo.id` (required)
+- `modelInfo.provider` (required)
+- `metrics.inputTokens` (required)
+- `metrics.outputTokens` (required)
+- `metrics.cacheReadTokens` (required; `0` allowed)
+- `metrics.cacheWriteTokens` (required; `0` allowed)
+- `metrics.cost` (required; `0` allowed)
+
+If an assistant turn emits multiple assistant messages in the same run, only
+the **last** assistant message of that turn carries `metrics`. Earlier
+assistant messages in the same turn still carry `modelInfo`.
+
+Enforced by
+[`withLatestAssistantTurnMetadata`](../src/services/session-data.ts) and
+covered by the LocalRuntimeHost e2e contract test in
+[`../src/runtime/host/local-runtime-host.e2e.test.ts`](../src/runtime/host/local-runtime-host.e2e.test.ts).
+
+## Failure and retry semantics
+
+1. **Turn succeeds.** Terminal assistant message has full `modelInfo` +
+   `metrics` as above.
+
+2. **Turn fails before any assistant output exists.** No assistant message is
+   appended. The persisted file remains a valid snapshot with no fabricated
+   usage/model metadata. Consumers must not assume every completed session
+   ends in an assistant message.
+
+3. **Transient failure followed by successful retry** (for example, auth
+   refresh + retry). Prior assistant messages retain their `modelInfo` and
+   `metrics`; the retry's terminal assistant message carries the new turn's
+   `metrics`. Prior metrics are not overwritten or dropped.
+
+4. **Multiple assistant messages in one turn.** The last assistant message of
+   that turn carries the turn's `metrics`. Earlier assistant messages in the
+   same turn carry `modelInfo` but no `metrics`.
+
+These behaviors are identical across CLI, desktop sidecar, and subagent /
+team-task session paths.
+
+## Versioning
+
+The top-level `version` field is a number. Today it is `1`. Any
+backwards-incompatible change to the shape above will increment this value.
+Additive fields (new optional top-level keys, new optional message fields)
+may appear without a version bump, so consumers should tolerate unknown
+keys.
+
+## Example
+
+A golden example for v1 lives at
+[`../fixtures/messages/success.messages.json`](../fixtures/messages/success.messages.json):
+single turn with reasoning + tool call + tool result + final text. It is
+provided as a copy-paste reference for downstream translators.
+
+The authoritative guarantees come from the real writer path and the
+end-to-end tests in
+[`../src/runtime/host/local-runtime-host.e2e.test.ts`](../src/runtime/host/local-runtime-host.e2e.test.ts)
+and [`../src/runtime/host/local-runtime-host.test.ts`](../src/runtime/host/local-runtime-host.test.ts); if
+the example ever drifts from what the writer emits, those tests are the
+source of truth.

codna/agent-core/vendor/cline/sdk/packages/core/fixtures/messages/success.messages.json

@@ -0,0 +1,72 @@
+{
+	"version": 1,
+	"updated_at": "2026-04-22T17:42:10.123Z",
+	"agent": "lead",
+	"sessionId": "fixture-success-01",
+	"messages": [
+		{
+			"id": "msg_user_1",
+			"role": "user",
+			"content": [
+				{ "type": "text", "text": "Inspect the README and summarize it." }
+			]
+		},
+		{
+			"id": "msg_assistant_1",
+			"role": "assistant",
+			"ts": 1745343730123,
+			"modelInfo": {
+				"id": "claude-sonnet-4-6",
+				"provider": "anthropic",
+				"family": "claude-sonnet-4"
+			},
+			"content": [
+				{
+					"type": "thinking",
+					"thinking": "I should read the README first before summarizing."
+				},
+				{
+					"type": "tool_use",
+					"id": "tool-call-1",
+					"name": "read_files",
+					"input": { "path": "/tmp/project/README.md" }
+				}
+			]
+		},
+		{
+			"id": "msg_user_2",
+			"role": "user",
+			"content": [
+				{
+					"type": "tool_result",
+					"tool_use_id": "tool-call-1",
+					"content": "# Project\n\nA small test fixture.",
+					"is_error": false
+				}
+			]
+		},
+		{
+			"id": "msg_assistant_2",
+			"role": "assistant",
+			"ts": 1745343731456,
+			"modelInfo": {
+				"id": "claude-sonnet-4-6",
+				"provider": "anthropic",
+				"family": "claude-sonnet-4"
+			},
+			"metrics": {
+				"inputTokens": 21,
+				"outputTokens": 8,
+				"cacheReadTokens": 3,
+				"cacheWriteTokens": 1,
+				"cost": 0.13
+			},
+			"content": [
+				{
+					"type": "text",
+					"text": "The README describes a small test fixture project."
+				}
+			]
+		}
+	]
+}

codna/agent-core/vendor/cline/sdk/packages/core/package.json

@@ -0,0 +1,80 @@
+{
+	"name": "@cline/core",
+	"description": "Cline Core SDK for Node Runtime",
+	"version": "0.0.44",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/cline/cline",
+		"directory": "sdk/packages/core"
+	},
+	"type": "module",
+	"types": "./dist/index.d.ts",
+	"main": "./dist/index.js",
+	"private": false,
+	"publishConfig": {
+		"access": "public"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./hub": {
+			"types": "./dist/hub/index.d.ts",
+			"import": "./dist/hub/index.js"
+		},
+		"./hub/daemon-entry": {
+			"types": "./dist/hub/daemon/entry.d.ts",
+			"import": "./dist/hub/daemon/entry.js"
+		},
+		"./telemetry": {
+			"types": "./dist/services/telemetry/index.d.ts",
+			"import": "./dist/services/telemetry/index.js"
+		}
+	},
+	"scripts": {
+		"build": "bun run ./bun.mts && bun tsc -p tsconfig.build.json",
+		"typecheck": "bun tsc -p tsconfig.dev.json --noEmit && bun run typecheck:smoke",
+		"typecheck:smoke": "bun tsc -p tsconfig.smoke.json --noEmit",
+		"test": "bun run test:unit && bun run test:e2e",
+		"test:live": "vitest run --config vitest.config.ts src/extensions/context/compaction.live.test.ts",
+		"test:unit": "vitest run --config vitest.config.ts",
+		"test:e2e": "vitest run --config vitest.e2e.config.ts",
+		"verify:routines": "zsh -lc 'bunx vitest run src/cron/schedule-service.test.ts --config vitest.config.ts'",
+		"test:watch": "vitest --config vitest.config.ts"
+	},
+	"dependencies": {
+		"@cline/agents": "workspace:*",
+		"@cline/shared": "workspace:*",
+		"@cline/llms": "workspace:*",
+		"@modelcontextprotocol/sdk": "^1.29.0",
+		"@opentelemetry/api": "^1.9.0",
+		"@opentelemetry/api-logs": "^0.214.0",
+		"@opentelemetry/exporter-logs-otlp-http": "^0.214.0",
+		"@opentelemetry/exporter-metrics-otlp-http": "^0.214.0",
+		"@opentelemetry/exporter-trace-otlp-http": "^0.214.0",
+		"@opentelemetry/resources": "^2.6.1",
+		"@opentelemetry/sdk-logs": "^0.214.0",
+		"@opentelemetry/sdk-metrics": "^2.6.1",
+		"@opentelemetry/sdk-trace-base": "^2.6.1",
+		"@opentelemetry/sdk-trace-node": "^2.6.1",
+		"@opentelemetry/semantic-conventions": "^1.40.0",
+		"jiti": "^2.7.0",
+		"node-machine-id": "^1.1.12",
+		"nanoid": "^5.1.7",
+		"simple-git": "3.36.0",
+		"ws": "^8.20.0",
+		"yaml": "^2.8.2",
+		"zod": "^4.3.6"
+	},
+	"devDependencies": {
+		"@types/ws": "^8.18.1"
+	},
+	"engines": {
+		"node": ">=22"
+	},
+	"files": [
+		"dist",
+		"!dist/**/*.d.ts.map"
+	]
+}