feat(metadata): Define the Shared Trace Contract

dist/metadata/constants.d.ts

@@ -0,0 +1,65 @@
+export declare const CODING_AGENT_SCHEMA_VERSION = "coding-agent-v1";
+export declare const CODING_AGENT_PURPOSE = "coding";
+export declare const CODING_AGENT_RUN_TYPES: readonly ["root", "llm", "tool", "subagent", "interrupted"];
+export declare const CODING_AGENT_RUN_SCOPES: {
+    readonly all: readonly ["root", "llm", "tool", "subagent", "interrupted"];
+    readonly rootInterrupted: readonly ["root", "interrupted"];
+    readonly subagent: readonly ["subagent"];
+    readonly tool: readonly ["tool"];
+    readonly llmTool: readonly ["llm", "tool"];
+    readonly chain: readonly ["root", "subagent", "interrupted"];
+};
+export declare const CODING_AGENT_SCHEMA_INTEGRATIONS: readonly ["claude-code", "openai-codex", "deepagents-code", "cursor", "pi"];
+export declare const CODING_AGENT_SUPPORTED_INTEGRATIONS: readonly ["claude-code", "cursor", "openai-codex"];
+export declare const CODING_AGENT_CORE_INTEGRATIONS: readonly ["claude-code", "cursor", "openai-codex"];
+export declare const CODING_AGENT_CODEX_INTEGRATION: readonly ["openai-codex"];
+export declare const CODING_AGENT_AGENT_TYPES: readonly ["root", "subagent", "middleware", "compaction"];
+export declare const CODING_AGENT_ALWAYS_FIELD_OPTIONS: {
+    readonly requirement: "always";
+};
+export declare const CODING_AGENT_WHERE_KNOWN_FIELD_OPTIONS: {
+    readonly requirement: "where_known";
+    readonly requiredWhereKnown: true;
+};
+export declare const CODING_AGENT_FIELD_DEFAULTS: {
+    readonly appliesTo: readonly ["root", "llm", "tool", "subagent", "interrupted"];
+    readonly type: "string";
+    readonly allowedValues: null;
+    readonly requirement: "contextual";
+    readonly requiredWhereKnown: false;
+    readonly metadataModeIntegrations: readonly [];
+};
+export declare const CODING_AGENT_STRUCTURAL_FIELD_DEFAULTS: {
+    readonly metadataModeIntegrations: readonly ["claude-code", "cursor", "openai-codex"];
+    readonly metadataSource: "structural";
+};
+export declare const CODING_AGENT_PROVIDER_FIELD_DEFAULTS: {
+    readonly metadataSource: "provider";
+    readonly providerIntegrations: readonly ["claude-code", "cursor", "openai-codex"];
+};
+export declare const CODING_AGENT_INTEGRATION_POLICIES: {
+    readonly "claude-code": {
+        readonly fullModePrecedence: "custom-wins";
+        readonly metadataModeUsesDirectMetadata: true;
+        readonly metadataModePreservesToolName: false;
+        readonly legacyAliases: true;
+    };
+    readonly cursor: {
+        readonly fullModePrecedence: "custom-wins";
+        readonly metadataModeUsesDirectMetadata: true;
+        readonly metadataModePreservesToolName: true;
+        readonly legacyAliases: false;
+    };
+    readonly "openai-codex": {
+        readonly fullModePrecedence: "structural-wins";
+        readonly metadataModeUsesDirectMetadata: false;
+        readonly metadataModePreservesToolName: false;
+        readonly legacyAliases: false;
+    };
+};
+export declare const TRUSTED_METADATA: unique symbol;
+export declare const METADATA_MODE_STATUS_VALUES: readonly ["running", "completed", "error"];
+export declare const METADATA_MODE_NAME = "metadata";
+export declare const CODING_AGENT_METADATA_PROVENANCE_FIELDS: readonly ["integration", "integrationVersion", "runtimeVersion", "threadId", "turnId", "turnNumber", "agentType", "runType", "approvalPolicy", "subagentId", "subagentType", "clearSubagent", "toolName", "runName", "skillName", "modelName", "usageMetadata", "providerMetadata", "runSpecific", "base"];
+export declare const CODING_AGENT_METADATA_PROJECTION_FIELDS: readonly [readonly ["integrationVersion", "ls_integration_version"], readonly ["runtimeVersion", "ls_agent_runtime_version"], readonly ["turnId", "turn_id"], readonly ["turnNumber", "turn_number"], readonly ["approvalPolicy", "approval_policy"], readonly ["subagentId", "ls_subagent_id"], readonly ["subagentType", "ls_subagent_type"], readonly ["skillName", "ls_skill_name"], readonly ["modelName", "ls_model_name"]];
+//# sourceMappingURL=constants.d.ts.map

dist/metadata/contract.d.ts

@@ -0,0 +1,3 @@
+import type { CodingAgentV1Contract } from "./models.js";
+export declare const CODING_AGENT_V1_CONTRACT: CodingAgentV1Contract;
+//# sourceMappingURL=contract.d.ts.map