@claxedo/agent-runtime-contract 0.8.0

package/dist/harnesses.d.ts

@@ -0,0 +1,96 @@
+export declare const AGENT_HARNESS_DEFINITIONS: readonly [{
+    readonly key: "claude";
+    readonly id: "claude";
+    readonly access: "native";
+    readonly label: "Claude";
+    readonly authEnv: "ANTHROPIC_API_KEY";
+    readonly authSlot: "anthropic";
+}, {
+    readonly key: "codex";
+    readonly id: "codex";
+    readonly access: "native";
+    readonly label: "Codex";
+    readonly authEnv: "OPENAI_API_KEY";
+    readonly authSlot: "openai";
+}, {
+    readonly key: "cursor";
+    readonly id: "cursor";
+    readonly access: "native";
+    readonly label: "Cursor";
+    readonly authEnv: "CURSOR_API_KEY";
+    readonly authSlot: "cursor";
+}, {
+    readonly key: "pi";
+    readonly id: "pi";
+    readonly access: "native";
+    readonly label: "Pi";
+    readonly authEnv: null;
+    readonly authSlot: null;
+}, {
+    readonly key: "opencode";
+    readonly id: "opencode";
+    readonly access: "native";
+    readonly label: "OpenCode";
+    readonly authEnv: null;
+    readonly authSlot: null;
+}];
+export declare const AGENT_HARNESS_IDS: readonly ["claude", "codex", "cursor", "pi", "opencode"];
+export declare const AGENT_HARNESS_ACCESSES: readonly ["connection", "native"];
+export declare const AGENT_HARNESS_KEYS: ("claude" | "codex" | "cursor" | "opencode" | "pi")[];
+export type AgentHarnessId = (typeof AGENT_HARNESS_IDS)[number];
+export type AgentHarnessAccess = (typeof AGENT_HARNESS_ACCESSES)[number];
+export type AgentHarnessKey = (typeof AGENT_HARNESS_KEYS)[number];
+export type NativeHarnessId = AgentHarnessId;
+/** The native harnesses driven through `SdkRuntimeDriver`; `opencode` is composed by `@claxedo/workspace-runtime/opencode` instead. */
+export type NativeSdkHarnessId = Extract<AgentHarnessId, "claude" | "codex" | "cursor" | "pi">;
+/**
+ * A harness identity's id field: one of the finite built-in ids, or a
+ * validated configured connection id for `access: "connection"` identities.
+ * Native dispatch stays closed — an open id is only ever accepted alongside
+ * `access: "connection"` and only through the accepted
+ * registry a host applies; it can never select a native adapter factory.
+ * The `string & {}` half keeps literal narrowing on the built-in ids intact.
+ */
+export type SessionHarnessId = AgentHarnessId | (string & {});
+export type AgentHarnessDefinition = (typeof AGENT_HARNESS_DEFINITIONS)[number];
+export type AgentHarnessTransport = "stdio" | "streamable-http" | "websocket";
+/**
+ * Open ACP connection ids are stable lowercase slugs: they become
+ * directory-safe store keys and query values.
+ * The finite built-in ids all match this shape too, which keeps one grammar.
+ */
+export declare const ACP_CONNECTION_ID_PATTERN: RegExp;
+export declare function isAcpConnectionId(id: string): boolean;
+export declare function harnessDefinition(input: {
+    id: string;
+    access: string;
+} | string): AgentHarnessDefinition | undefined;
+export declare function isAgentHarnessId(id: string): id is AgentHarnessId;
+export declare function isAgentHarnessAccess(access: string): access is AgentHarnessAccess;
+export declare function normalizeAgentHarnessTransport(input: unknown): AgentHarnessTransport | undefined;
+export declare function harnessKey(input: {
+    id: SessionHarnessId;
+    access: AgentHarnessAccess;
+}): string | undefined;
+export declare function normalizeHarnessIdentity(input: unknown): {
+    id: SessionHarnessId;
+    access: AgentHarnessAccess;
+} | undefined;
+/** A session's harness identity: a built-in id, or a configured connection id. */
+export type SessionHarness = {
+    id: SessionHarnessId;
+    access: AgentHarnessAccess;
+};
+/**
+ * How a harness takes a session's standing instruction block, and when.
+ *
+ * `turn-system-prompt` — a real system prompt, composed into every turn.
+ * `thread-start` — a real system prompt given once when the harness thread is
+ *   created; the thread holds it, so repeating it per turn would send it twice.
+ * `prompt-prefix` — no separate slot: the block rides at the head of the same
+ *   prompt the user's own text is in, on every turn.
+ * `none` — no channel; a session created with a block is refused rather than
+ *   running under instructions the harness never received.
+ */
+export declare const HARNESS_INSTRUCTION_CHANNELS: readonly ["turn-system-prompt", "thread-start", "prompt-prefix", "none"];
+export type HarnessInstructionChannel = (typeof HARNESS_INSTRUCTION_CHANNELS)[number];

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export declare const AGENT_RUNTIME_CONTRACT_VERSION = 1;
+export * from "./availability";
+export * from "./capabilities";
+export * from "./claims";
+export * from "./connections";
+export * from "./content";
+export * from "./credential-broker-errors";
+export * from "./errors";
+export * from "./events";
+export * from "./files";
+export * from "./harness-effort";
+export * from "./harness-table";
+export * from "./harnesses";
+export * from "./question-answers";
+export * from "./session-group";
+export * from "./sessions";
+export * from "./tool-names";
+export * from "./usage-windows";
+export * from "./values";