codna 0.1.0__py3-none-any.whl

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

@@ -0,0 +1,184 @@
+export type {
+	AgentRunResult,
+	AgentRunStatus,
+	WorkspaceInfo,
+	WorkspaceManifest,
+} from "@cline/shared";
+export { ClineCore } from "./ClineCore";
+export type {
+	ClineCoreListHistoryOptions,
+	ClineCoreOptions,
+	ClineCoreStartInput,
+	HubOptions,
+	RemoteOptions,
+} from "./cline-core/types";
+export type {
+	LoadAgentPluginFromPathOptions,
+	ResolveAgentPluginPathsOptions,
+} from "./extensions";
+export {
+	discoverPluginModulePaths,
+	loadAgentPluginFromPath,
+	loadAgentPluginsFromPaths,
+	resolveAgentPluginPaths,
+	resolveAndLoadAgentPlugins,
+	resolvePluginConfigSearchPaths,
+	resolvePluginSkillDirectoriesFromPaths,
+} from "./extensions";
+export type {
+	CreateInstructionWatcherOptions,
+	CreateRulesConfigDefinitionOptions,
+	CreateSkillsConfigDefinitionOptions,
+	CreateUserInstructionConfigServiceOptions,
+	CreateWorkflowsConfigDefinitionOptions,
+	ParseMarkdownFrontmatterResult,
+	RuleConfig,
+	SkillConfig,
+	UnifiedConfigDefinition,
+	UnifiedConfigFileCandidate,
+	UnifiedConfigFileContext,
+	UnifiedConfigRecord,
+	UnifiedConfigWatcherEvent,
+	UnifiedConfigWatcherOptions,
+	UserInstructionConfig,
+	UserInstructionConfigRecord,
+	UserInstructionConfigService,
+	UserInstructionConfigType,
+	WorkflowConfig,
+} from "./extensions/config";
+export {
+	createRulesConfigDefinition,
+	createSkillsConfigDefinition,
+	createUserInstructionConfigService,
+	createWorkflowsConfigDefinition,
+	parseRuleConfigFromMarkdown,
+	parseSkillConfigFromMarkdown,
+	parseWorkflowConfigFromMarkdown,
+	RULES_CONFIG_DIRECTORY_NAME,
+	resolveRulesConfigSearchPaths,
+	resolveSkillsConfigSearchPaths,
+	resolveWorkflowsConfigSearchPaths,
+	SKILLS_CONFIG_DIRECTORY_NAME,
+	UnifiedConfigFileWatcher,
+	WORKFLOWS_CONFIG_DIRECTORY_NAME,
+} from "./extensions/config";
+export type {
+	BuiltinToolAvailabilityContext,
+	ToolCatalogEntry,
+} from "./extensions/tools";
+export {
+	getCoreAcpToolNames,
+	getCoreBuiltinToolCatalog,
+	getCoreDefaultEnabledToolIds,
+	getCoreHeadlessToolNames,
+	resolveCoreSelectedToolIds,
+	TEAM_TOOL_NAMES,
+} from "./extensions/tools";
+export type { RuntimeCapabilities } from "./runtime/capabilities";
+export type { SessionBackend } from "./runtime/host/host";
+export type {
+	PendingPromptMutationResult,
+	PendingPromptsDeleteInput,
+	PendingPromptsListInput,
+	PendingPromptsRuntimeService,
+	PendingPromptsServiceApi,
+	PendingPromptsUpdateInput,
+	RuntimeHost,
+	RuntimeHost as SessionHost,
+	RuntimeHostMode,
+	SendSessionInput,
+	SessionAccumulatedUsage,
+	SessionUsageSummary,
+	StartSessionInput,
+	StartSessionResult,
+} from "./runtime/host/runtime-host";
+export type {
+	BuiltRuntime as RuntimeEnvironment,
+	RuntimeBuilder,
+	RuntimeBuilderInput,
+	SessionRuntime,
+} from "./runtime/orchestration/session-runtime";
+export type {
+	SandboxCallOptions,
+	SubprocessSandboxOptions,
+} from "./runtime/tools/subprocess-sandbox";
+export { SubprocessSandbox } from "./runtime/tools/subprocess-sandbox";
+export type { GlobalSettings } from "./services/global-settings";
+export {
+	filterDisabledPluginPaths,
+	filterDisabledTools,
+	filterExtensionToolRegistrations,
+	GlobalSettingsSchema,
+	isAutoUpdateEnabledGlobally,
+	isPluginDisabledGlobally,
+	isTelemetryOptedOutGlobally,
+	isToolDisabledGlobally,
+	readGlobalSettings,
+	resolveDisabledPluginPaths,
+	resolveDisabledToolNames,
+	setAutoUpdateEnabledGlobally,
+	setDisabledPlugin,
+	setDisabledTools,
+	setTelemetryOptOutGlobally,
+	toggleDisabledTool,
+	writeGlobalSettings,
+} from "./services/global-settings";
+export type {
+	ListPluginToolsResult,
+	PluginToolSummary,
+} from "./services/plugin-tools";
+export {
+	listPluginTools,
+	listPluginToolsWithDiagnostics,
+} from "./services/plugin-tools";
+export type {
+	WorkspaceManager,
+	WorkspaceManagerEvent,
+} from "./services/workspace/workspace-manager";
+export type { SessionManifest } from "./session/models/session-manifest";
+export type { SessionRow } from "./session/models/session-row";
+export type {
+	CreateRootSessionWithArtifactsInput,
+	RootSessionArtifacts,
+} from "./session/services/session-service";
+export type {
+	CoreSessionCheckpointSnapshot,
+	CoreSessionSnapshot,
+} from "./session/session-snapshot";
+export type {
+	SessionCheckpointRestoreContext,
+	SessionCheckpointRestoreResult,
+	SessionVersioningErrorCode,
+} from "./session/session-versioning-service";
+export type {
+	ChatMessage,
+	ChatSessionConfig,
+	ChatSessionStatus,
+	ChatSummary,
+	ChatViewState,
+} from "./types/chat-schema";
+export type { SessionSource, SessionStatus } from "./types/common";
+export type {
+	CoreAgentMode,
+	CoreModelConfig,
+	CoreRuntimeFeatures,
+	CoreSessionConfig,
+} from "./types/config";
+export type {
+	CoreSessionEvent,
+	SessionChunkEvent,
+	SessionEndedEvent,
+	SessionPendingPrompt,
+	SessionPendingPromptSubmittedEvent,
+	SessionPendingPromptsEvent,
+	SessionTeamProgressEvent,
+	SessionToolEvent,
+} from "./types/events";
+export type { SessionMessagesArtifactUploader } from "./types/session";
+export type {
+	SessionHistoryMetadata,
+	SessionHistoryRecord,
+	SessionRecord,
+	SessionRef,
+} from "./types/sessions";
+export type { ArtifactStore, SessionStore, TeamStore } from "./types/storage";

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

@@ -0,0 +1,3 @@
+import { version } from "../package.json";
+
+export const CORE_BUILD_VERSION = version;

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

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

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

@@ -0,0 +1,8 @@
+{
+	"extends": "./tsconfig.json",
+	"compilerOptions": {
+		"rootDir": "..",
+		"noUnusedLocals": false,
+		"noUnusedParameters": false
+	}
+}

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

@@ -0,0 +1,24 @@
+{
+	"extends": "../tsconfig.base.json",
+	"compilerOptions": {
+		"outDir": "./dist",
+		"rootDir": "./src",
+		"sourceMap": false,
+		"emitDeclarationOnly": true,
+		"paths": {
+			"@cline/agents": ["../agents/src/index.ts"],
+			"@cline/agents/*": ["../agents/src/*", "../agents/src/*/index.ts"],
+			"@cline/llms": ["../llms/src/index.ts"],
+			"@cline/llms/browser": ["../llms/src/index.browser.ts"],
+			"@cline/shared": ["../shared/src/index.ts"],
+			"@cline/shared/automation": ["../shared/src/automation/index.ts"],
+			"@cline/shared/browser": ["../shared/src/index.browser.ts"],
+			"@cline/shared/db": ["../shared/src/db/index.ts"],
+			"@cline/shared/storage": ["../shared/src/storage/index.ts"],
+			"@cline/shared/types": ["../shared/src/types/index.ts"],
+			"@cline/shared/*": ["../shared/src/*", "../shared/src/*/index.ts"]
+		}
+	},
+	"include": ["src/**/*"],
+	"exclude": ["node_modules", "dist", "fixtures"]
+}

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

@@ -0,0 +1,18 @@
+{
+	"extends": "../tsconfig.base.json",
+	"compilerOptions": {
+		"baseUrl": ".",
+		"rootDir": "..",
+		"noEmit": true,
+		"noUnusedLocals": false,
+		"noUnusedParameters": false,
+		"paths": {
+			"@cline/agents": ["../agents/src/index.ts"],
+			"@cline/agents/*": ["../agents/src/*", "../agents/src/*/index.ts"],
+			"@cline/llms": ["../llms/src/index.ts"],
+			"@cline/shared": ["../shared/src/index.ts"],
+			"@cline/shared/*": ["../shared/src/*", "../shared/src/*/index.ts"]
+		}
+	},
+	"include": ["scripts/**/*", "src/**/*"]
+}

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

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

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

@@ -0,0 +1,10 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+	test: {
+		environment: "node",
+		include: ["src/**/*.e2e.test.ts"],
+		testTimeout: 30_000,
+		hookTimeout: 30_000,
+	},
+});

codna/agent-core/vendor/cline/sdk/packages/llms/AGENTS.md

@@ -0,0 +1,39 @@
+---
+description: Development guidance for the @cline/llms package.
+globs: "src/**/*.ts,src/**/*.tsx,*.md"
+alwaysApply: true
+---
+
+# @cline/llms Development Guidance
+
+## Provider Option Routing
+
+- `models.dev` catalog data and AI SDK provider behavior are the default
+  sources of truth for general model/provider support.
+- Do not build a broad Cline-maintained model capability or behavior registry.
+- `GatewayModelCapability` is semantic: what the model can do, not provider
+  quirks, default behavior, or wire-format details.
+- Stable, reliable known-model facts belong in typed `ModelInfo.metadata`
+  helpers or `src/providers/model-facts.ts`.
+- Stable provider routing facts belong in `GatewayProviderMetadata.routing`
+  and the relevant builtin provider manifest. For example, if a native
+  provider uses a known reasoning wire format for a model route, add a typed
+  `GatewayReasoningFormat` value and route metadata instead of matching that
+  provider id directly in a rule predicate.
+- Provider wire-format encoding belongs in `PROVIDER_OPTION_RULES` and codec
+  helpers under `src/providers/routing`.
+- Local or dynamic provider fallbacks, such as Ollama or routed model-id
+  heuristics, are allowed only as documented, narrowly scoped, tested
+  exceptions.
+- Fallback heuristics need negative or graceful-degradation tests, not only
+  happy-path tests.
+
+When changing provider options, keep the split explicit:
+
+```text
+request intent + model/provider facts -> named provider-option rule -> provider wire format
+```
+
+If the same fact-resolution logic is needed across several providers, use a
+shared helper first. Add a new registry only after repeated logic proves the
+rule table and helpers are no longer enough.

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

@@ -0,0 +1,227 @@
+# [experimental] @cline/llms
+
+`@cline/llms` is the model and provider layer for the Cline SDK. It gives
+you typed provider settings, model catalogs, shared gateway contracts, and
+AI SDK-backed handler creation for supported LLM backends.
+
+## What You Get
+
+- `@cline/llms/runtime` for declarative config and runtime registry creation
+- `@cline/llms/providers` for handler creation and provider settings/types
+- `@cline/llms/models` for model catalogs and query helpers
+- `@cline/llms` root exports for the gateway registry and shared llm contracts
+
+## Installation
+
+```bash
+npm install @cline/llms zod
+```
+
+## Quick Start
+
+```ts
+import { createHandler } from "@cline/llms";
+
+const handler = createHandler({
+	providerId: "anthropic",
+	apiKey: process.env.ANTHROPIC_API_KEY ?? "",
+	modelId: "claude-sonnet-4-6",
+});
+
+for await (const chunk of handler.createMessage("You are a concise assistant.", [
+	{ role: "user", content: [{ type: "text", text: "Say hello." }] },
+])) {
+	console.log(chunk);
+}
+```
+
+## Main APIs
+
+### Runtime
+
+Use `createLlmsRuntime(...)` when you want a small registry around:
+
+- configured providers and their default models
+- builtin provider discovery via `getBuiltInProviders()`
+- custom provider registration via `registerBuiltinProvider(...)`
+- handler creation for builtin or custom providers
+
+Preferred import:
+
+```ts
+import { createLlmsRuntime, defineLlmsConfig } from "@cline/llms/runtime";
+```
+
+### Providers
+
+Use `@cline/llms/providers` for:
+
+- `createHandler(...)` and `createHandlerAsync(...)`
+- `ProviderSettings` and `ProviderSettingsSchema`
+- `ProviderConfig`
+- `Message` and `ApiStreamChunk`
+
+Built-in providers are routed through the internal gateway registry and backed by
+AI SDK provider implementations. Shared gateway contracts are exported from both
+`@cline/llms` and `@cline/shared`.
+
+### Models
+
+Use `@cline/llms/models` when you need generated provider/model metadata for
+selection UIs, defaults, or validation.
+
+For generated catalog field semantics and token-limit behavior, see
+[`src/catalog/README.md`](./src/catalog/README.md).
+
+## Entry Points
+
+- `@cline/llms`: runtime-focused convenience entrypoint
+- `@cline/llms/node`: explicit Node/runtime entrypoint
+- `@cline/llms/browser`: browser-safe bundle
+- `@cline/llms/runtime`: focused runtime entrypoint
+- `@cline/llms/models`: model catalog/query entrypoint
+- `@cline/llms/providers`: provider handler/settings entrypoint
+
+## Related Packages
+
+- `@cline/agents`: agent loop and tool execution
+- `@cline/core`: stateful runtime assembly and provider settings storage
+
+## More 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)
+
+## Live Provider Smoke Test
+
+Use this for API-key-backed provider validation against real endpoints.
+
+1. Ensure provider keys are present in your environment (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GEMINI_API_KEY`, `CLINE_API_KEY`, etc.).
+2. Use the sample config at `packages/llms/src/tests/live-providers.example.json` as the providers list.
+3. Run:
+
+```bash
+LLMS_LIVE_TESTS=1 \
+LLMS_LIVE_PROVIDERS_PATH=/absolute/path/to/packages/llms/src/tests/live-providers.example.json \
+bun -F @cline/llms run test:live
+```
+
+Reasoning-focused live run (same command, different flags):
+
+```bash
+LLMS_LIVE_REASONING_TESTS=1 \
+LLMS_LIVE_REASONING_PROVIDERS_PATH=/absolute/path/to/packages/llms/src/tests/live-providers.reasoning.example.json \
+bun -F @cline/llms run test:live
+```
+
+Tool-use-focused live run (same command, different flags):
+
+```bash
+LLMS_LIVE_TOOL_TESTS=1 \
+LLMS_LIVE_TOOL_PROVIDERS_PATH=/absolute/path/to/packages/llms/src/tests/live-providers.tools.example.json \
+bun -F @cline/llms run test:live
+```
+
+Optional:
+
+- `LLMS_LIVE_PROVIDER_TIMEOUT_MS=120000` to increase per-provider timeout.
+- `LLMS_LIVE_PROVIDER_RETRIES=2` to retry transient upstream/provider failures per provider (total attempts = retries + 1).
+- `LLMS_LIVE_PROVIDER_CONCURRENCY=3` to run multiple provider entries in parallel. Defaults to `3`; lower it if you need stricter provider rate-limit behavior.
+- Point `LLMS_LIVE_PROVIDERS_PATH` to a custom file if you want a narrower provider set.
+- Point `LLMS_LIVE_REASONING_PROVIDERS_PATH` to a custom file for reasoning-enabled suites.
+- Point `LLMS_LIVE_TOOL_PROVIDERS_PATH` to a custom file for tool-use suites.
+- Use `apiKeyEnv`, `baseUrlEnv`, and `headersEnv` in a provider entry when a live config needs secrets without writing them to JSON.
+- When recording provider cassettes for committed replay tests, set `CLINE_VCR=record` and `CLINE_VCR_INCLUDE_REQUEST_BODY=1` so playback also verifies the sanitized request body contract.
+
+OpenAI Codex subscription live runs use the saved OAuth credentials from `~/.cline/data/settings/providers.json` after `cline auth --provider openai-codex`. Point the plain or reasoning suite at `packages/llms/src/tests/live-providers.openai-codex.example.json` or `packages/llms/src/tests/live-providers.openai-codex.reasoning.example.json`.
+
+Per-provider live assertions are configured in the JSON via `expectations`:
+
+- `requireUsage`: fail if no `usage` chunk is emitted (defaults to `true`; set to `false` to opt out).
+- `requireCacheReadTokens`: fail unless `cacheReadTokens > 0` (auto-runs at least 2 attempts with a long cache probe prompt if no prompt override is provided).
+- `minCacheReadTokens`: stricter cache floor check.
+- `requireReasoningChunk`: fail unless at least one reasoning chunk is emitted.
+- `requireNoReasoningChunk`: fail if any reasoning chunk is emitted.
+- `minInputTokens` / `minOutputTokens`: enforce lower bounds.
+- `requireToolCall`: fail unless at least one `tool_calls` chunk is emitted.
+
+In reasoning suites, set `requireReasoningSignal: true` to require either a reasoning chunk or `thoughtsTokenCount > 0` (provider-dependent; can be flaky on some endpoints).
+To check that disabling reasoning actually suppresses reasoning output across models, use `packages/llms/src/tests/live-providers.reasoning-disabled.example.json`; it covers direct and routed provider paths across `cline`, `openai`, `openrouter`, `anthropic`, `gemini`, `vercel-ai-gateway`, `zai`, and `deepseek` where model support exists, with `reasoning.enabled: false` and `requireNoReasoningChunk: true`.
+
+Common live failure classes:
+
+- `Overloaded`: provider/model capacity issue or transient upstream saturation.
+- `Insufficient Balance`: the provider account needs funds.
+- `Model Not Exist`: the model id is not available for that provider/account.
+- assertion failures such as `expected no reasoning chunks`: likely real SDK/provider-option behavior regressions.
+
+### Adding A Model To Live Tests
+
+Add a new entry under the `providers` object in either config file:
+
+- Cache/smoke suite: `packages/llms/src/tests/live-providers.example.json`
+- Reasoning suite: `packages/llms/src/tests/live-providers.reasoning.example.json`
+- Reasoning-disabled suite (asserts no reasoning chunks when reasoning is off): `packages/llms/src/tests/live-providers.reasoning-disabled.example.json`
+- Tool-use suite: `packages/llms/src/tests/live-providers.tools.example.json`
+
+Minimal smoke/cache entry:
+
+```json
+"my-openai-model": {
+  "settings": {
+    "provider": "openai",
+    "model": "gpt-5.4"
+  },
+  "expectations": {
+    "requireUsage": true
+  }
+}
+```
+
+Cache-asserted entry (auto-enforces multi-run cache probe):
+
+```json
+"my-cache-model": {
+  "settings": {
+    "provider": "openai",
+    "model": "gpt-5.4"
+  },
+  "expectations": {
+    "requireUsage": true,
+    "requireCacheReadTokens": true
+  }
+}
+```
+
+Reasoning entry:
+
+```json
+"my-reasoning-model": {
+  "settings": {
+    "provider": "anthropic",
+    "model": "claude-sonnet-4-6",
+    "reasoning": {
+      "effort": "high"
+    }
+  },
+  "expectations": {
+    "requireUsage": true,
+    "requireReasoningChunk": true
+  }
+}
+```
+
+Tool-use entry:
+
+```json
+"my-tools-model": {
+  "settings": {
+    "provider": "openai",
+    "model": "gpt-5.4"
+  },
+  "expectations": {
+    "requireUsage": true,
+    "requireToolCall": true
+  }
+}
+```

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

@@ -0,0 +1,49 @@
+/// <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;
+const sourcemap = Bun.env.CLINE_SOURCEMAPS === "1" ? "linked" : "none";
+
+// Keep published third-party runtime packages external, but bundle internal workspace code.
+const external = Object.keys({
+	...(packageJson.dependencies ?? {}),
+	...(packageJson.peerDependencies ?? {}),
+}).filter((name) => !name.startsWith("@cline/"));
+
+const builds: Parameters<typeof Bun.build>[0][] = [
+	{
+		entrypoints: ["./src/index.ts", "./src/models.ts", "./src/providers.ts"],
+		outdir: "./dist",
+		target: "node",
+		external,
+		packages: "bundle",
+		minify: true,
+		sourcemap,
+	},
+	{
+		entrypoints: ["./src/index.browser.ts", "./src/providers.browser.ts"],
+		outdir: "./dist",
+		target: "browser",
+		external,
+		packages: "bundle",
+		minify: true,
+		sourcemap,
+	},
+];
+
+for (const config of builds) {
+	const result = await Bun.build(config);
+
+	if (result.logs.length > 0) {
+		for (const log of result.logs) {
+			console.warn(log);
+		}
+	}
+}