cclaw-cli 7.7.0 → 8.1.0

package/dist/harness-adapters.d.ts

@@ -1,151 +0,0 @@
-import { type HarnessId } from "./types.js";
-export declare const CCLAW_MARKER_START = "<!-- cclaw-start -->";
-export declare const CCLAW_MARKER_END = "<!-- cclaw-end -->";
-export type SubagentFallback = 
-/** Harness has real, isolated named subagent dispatch; no fallback needed. */
-"native"
-/**
- * Harness has a real dispatcher but not cclaw-named agents. cclaw maps each
- * named role to the available built-in/generic subagent surface with a
- * structured role prompt.
- */
- | "generic-dispatch"
-/**
- * No isolated dispatch — the agent performs the named subagent's role
- * in-session with an explicit role announce + delegation-log entry
- * carrying evidenceRefs. Accepted as `completed` only when no true dispatch
- * surface exists.
- */
- | "role-switch"
-/**
- * Reserved escape hatch for future harnesses with no parity path.
- * Current shipped harnesses do not use this fallback.
- */
- | "waiver";
-/**
- * How a harness discovers cclaw's `/cc*` entry points.
- *
- * - `command` — harness has a native custom slash-command system and reads
- *   flat markdown files from `<commandDir>/<fileName>.md` (Claude Code,
- *   Cursor, OpenCode).
- * - `skill` — harness ignores flat commands and reads SKILL.md from
- *   directories under a skills root (Codex CLI ≥0.89, Jan 2026). cclaw
- *   writes `<commandDir>/<skillName>/SKILL.md` and the agent invokes it
- *   either via `/use <skillName>` or via automatic description matching
- *   when the user's text mentions `/cc`, `/cc-idea`, or `/cc-cancel`.
- */
-export type ShimKind = "command" | "skill";
-export interface HarnessAdapter {
-    id: HarnessId;
-    reality: {
-        declaredSupport: "full" | "generic" | "partial" | "none";
-        runtimeLaunch: string;
-        proofRequired: string;
-        proofSource: string;
-    };
-    /**
-     * Root directory where cclaw writes `/cc*` entry points.
-     *
-     * - For `shimKind: "command"` this is the directory containing flat
-     *   markdown files (`<commandDir>/cc.md`, `<commandDir>/cc-idea.md`, …).
-     * - For `shimKind: "skill"` this is the skills root that contains
-     *   per-skill subdirectories (`<commandDir>/<skillName>/SKILL.md`).
-     */
-    commandDir: string;
-    /** See {@link ShimKind}. Defaults to `"command"` if unspecified at a callsite. */
-    shimKind: ShimKind;
-    capabilities: {
-        /**
-         * Level of native subagent dispatch:
-         * - `full`    — isolated workers + user-defined named subagents (Claude,
-         *   OpenCode, Codex custom agents).
-         * - `generic` — generic dispatcher without cclaw-named agents (Cursor).
-         * - `partial` — limited or plugin-only dispatch surface.
-         * - `none`    — no dispatch primitive at all.
-         */
-        nativeSubagentDispatch: "full" | "generic" | "partial" | "none";
-        hookSurface: "full" | "plugin" | "limited" | "none";
-        /**
-         * Structured-ask primitive exposed by the harness.
-         *
-         * - `AskUserQuestion`   — Claude Code native tool (≤5 options × multi-question).
-         * - `AskQuestion`       — Cursor native tool (≥2 options, multi-question, `allow_multiple`).
-         * - `question`          — OpenCode native tool (header + options + "type custom"
-         *   fallback); **gated**: requires `permission.question: "allow"` in
-         *   `opencode.json`, and for ACP clients additionally needs
-         *   `OPENCODE_ENABLE_QUESTION_TOOL=1`.
-         * - `request_user_input` — Codex CLI tool (1-3 short questions); experimental
-         *   and primarily surfaced inside Plan / Collaboration mode templates
-         *   (`codex-rs/collaboration-mode-templates`). Available to agents running
-         *   inside Codex but may be hidden on very old builds.
-         * - `plain-text`        — fallback only; used when no native primitive is
-         *   available (no shipping harness uses this).
-         */
-        structuredAsk: "AskUserQuestion" | "AskQuestion" | "question" | "request_user_input" | "plain-text";
-        /**
-         * Declared fallback pattern used when the harness cannot satisfy a
-         * mandatory delegation natively. Drives `checkMandatoryDelegations`
-         * and generated harness guidance.
-         */
-        subagentFallback: SubagentFallback;
-    };
-}
-export declare function harnessShimFileNames(): string[];
-/** Skill folder names cclaw writes under `<commandDir>` for skill-kind harnesses. */
-export declare function harnessShimSkillNames(): string[];
-export declare const HARNESS_ADAPTERS: Record<HarnessId, HarnessAdapter>;
-export declare function harnessDispatchSurface(harnessId: HarnessId): string;
-export interface HarnessDelegationRecipe {
-    harnessId: HarnessId;
-    dispatchSurface: "claude-task" | "cursor-task" | "opencode-agent" | "codex-agent";
-    agentDefinitionDirectory: string;
-    agentDefinitionExample: string;
-    invocationLine: string;
-    fulfillmentMode: "isolated" | "generic-dispatch";
-    /**
-     * Step-by-step lifecycle commands rendered with structural placeholders only:
-     *  `<agent-name>`, `<stage>`, `<run-id>`, `<span-id>`, `<dispatch-id>`,
-     *  `<agent-def-path>`, `<iso-ts>`. No domain/example values.
-     */
-    lifecycleCommands: string[];
-}
-/**
- * Per-harness lifecycle recipe used by skills and harness docs to render the
- * canonical scheduled -> launched -> acknowledged -> completed sequence in
- * structural form. The recipe never embeds task-specific or domain-specific
- * placeholders — only neutral angle-bracket tokens (`<agent-name>`, `<stage>`,
- * `<span-id>`, `<dispatch-id>`, `<agent-def-path>`, `<iso-ts>`).
- *
- * This function returns the **canonical primary recipe** for each shipped
- * harness — the dispatch surface that maps 1:1 onto the harness's vendor-
- * native subagent surface:
- *
- * - `claude` -> `claude-task` (isolated)
- * - `cursor` -> `cursor-task` (generic-dispatch)
- * - `opencode` -> `opencode-agent` (isolated)
- * - `codex` -> `codex-agent` (isolated)
- *
- * The remaining `--dispatch-surface` enum values (`generic-task`,
- * `role-switch`, `manual`) are universal fallback paths available to any
- * harness when the canonical surface is unavailable; they are documented in
- * the dispatch-surface table in `docs/harnesses.md` rather than per-harness
- * here, because their lifecycle commands are structurally identical except
- * for the surface token. No shipped harness has a non-canonical *primary*
- * surface, so this function only needs to enumerate the four canonical
- * recipes above.
- */
-export declare function harnessDelegationRecipe(harnessId: HarnessId): HarnessDelegationRecipe;
-/** All four harness recipes in tier-stable order. */
-export declare function harnessDelegationRecipes(): HarnessDelegationRecipe[];
-export declare function harnessDispatchFallback(harnessId: HarnessId): string;
-export type HarnessTier = "tier1" | "tier2" | "tier3";
-export declare function harnessTier(harnessId: HarnessId): HarnessTier;
-/**
- * Harness IDs ordered from best (tier1) to least-capable. Stable sort — same
- * tier preserves declaration order.
- */
-export declare function harnessesByTier(): HarnessId[];
-/** Removes the cclaw AGENTS.md block. */
-export declare function stripCclawBlock(content: string): string;
-export declare function removeCclawFromAgentsMd(projectRoot: string): Promise<void>;
-export declare function syncHarnessShims(projectRoot: string, harnesses: HarnessId[]): Promise<void>;