@cleocode/contracts 2026.6.11 → 2026.6.13

package/src/tools/web-tools.ts

@@ -0,0 +1,247 @@
+/**
+ * Web + browser agent-tool I/O contracts (T1742 · epic T11456 · SG-TOOLS).
+ *
+ * The shared, types-only I/O shapes for the `web` toolset surfaced through the
+ * `AgentToolRegistry` (`packages/core/src/tools/agent-registry.ts`), on top of
+ * the terminal/file/search/git families ({@link ./agent-tools.js}):
+ *
+ *   - **web_search** — pluggable, backend-agnostic web search
+ *     ({@link WebSearchInput} / {@link WebSearchResult}). NO hard paid-API dep:
+ *     a backend is resolved at call time and the tool degrades gracefully to an
+ *     `unavailable` result when none is configured.
+ *   - **web_extract** — fetch a URL and convert its HTML body to markdown
+ *     ({@link WebExtractInput} / {@link WebExtractResult}).
+ *   - **browser_*** — Playwright-driven browser automation
+ *     ({@link BrowserNavigateInput} … {@link BrowserVisionResult}). Playwright is
+ *     an OPTIONAL, lazily-loaded dependency — these tools' `available()` predicate
+ *     returns `false` (with an install hint) when it is absent.
+ *
+ * The web tools compose over the `net` side-effect surface; the browser tools
+ * over a Playwright-managed `shell`-class process. Like every agent tool, their
+ * executables perform side effects through the injected `GuardedToolSurface` (or,
+ * for the AI call in {@link BrowserVisionResult}, through the E9
+ * `resolveLLMForSystem` chokepoint) — never a raw provider/network bypass.
+ * Types-only — no runtime logic (Gate 10 `contracts-purity`).
+ *
+ * @epic T11456
+ * @task T1742
+ * @see ./agent-tools.js — the terminal/file/search/git family I/O shapes
+ */
+
+// ---------------------------------------------------------------------------
+// web_search — pluggable, backend-agnostic
+// ---------------------------------------------------------------------------
+
+/**
+ * Identifier of a {@link WebSearchInput} backend.
+ *
+ * - `duckduckgo` — DuckDuckGo's keyless HTML endpoint (no API key required).
+ * - `searxng` — a self-hosted / public SearXNG JSON instance (URL via config/env).
+ * - `auto` — try each configured backend in priority order, first success wins.
+ *
+ * NONE require a paid API key; the set is open by design so a deployment can
+ * register its own backend. The string union here is the canonical builtin set.
+ */
+export type WebSearchBackendId = 'duckduckgo' | 'searxng' | 'auto';
+
+/** Input for the `web_search` tool. */
+export interface WebSearchInput {
+  /** Free-text search query. */
+  readonly query: string;
+  /** Maximum number of results to return. Defaults to 10. */
+  readonly maxResults?: number;
+  /**
+   * Preferred backend. Defaults to `auto` — the first configured/reachable
+   * backend answers. An explicit id pins a single backend.
+   */
+  readonly backend?: WebSearchBackendId;
+}
+
+/** A single web-search hit. */
+export interface WebSearchHit {
+  /** Result title. */
+  readonly title: string;
+  /** Absolute result URL. */
+  readonly url: string;
+  /** Snippet / description (may be empty). */
+  readonly snippet: string;
+}
+
+/** Result of `web_search`. */
+export interface WebSearchResult {
+  /** The originating query (echoed for traceability). */
+  readonly query: string;
+  /** Hits in backend-ranked order (empty when none / unavailable). */
+  readonly results: readonly WebSearchHit[];
+  /** The backend that actually answered, or `null` when none was available. */
+  readonly backend: WebSearchBackendId | null;
+  /**
+   * `true` when NO backend could answer (none configured, network egress
+   * denied, or every backend failed). Callers MUST treat this as a soft
+   * "no search capability" signal — it is NOT an error.
+   */
+  readonly unavailable: boolean;
+  /** Human-readable reason when {@link WebSearchResult.unavailable} is `true`. */
+  readonly reason?: string;
+}
+
+// ---------------------------------------------------------------------------
+// web_extract — URL → markdown
+// ---------------------------------------------------------------------------
+
+/** Input for the `web_extract` tool. */
+export interface WebExtractInput {
+  /** Absolute URL to fetch and convert. */
+  readonly url: string;
+  /** Hard timeout in milliseconds. Defaults to 30000. */
+  readonly timeoutMs?: number;
+  /**
+   * Cap on the markdown length (characters). Output beyond this is truncated
+   * and {@link WebExtractResult.truncated} set. Defaults to 100000.
+   */
+  readonly maxChars?: number;
+}
+
+/** Result of `web_extract`. */
+export interface WebExtractResult {
+  /** The fetched URL. */
+  readonly url: string;
+  /** HTTP status code of the fetch. */
+  readonly status: number;
+  /** Document `<title>`, when present. */
+  readonly title: string;
+  /** The page body converted to markdown. */
+  readonly markdown: string;
+  /** Whether {@link WebExtractInput.maxChars} truncated the markdown. */
+  readonly truncated: boolean;
+}
+
+// ---------------------------------------------------------------------------
+// browser_* — Playwright-driven automation
+// ---------------------------------------------------------------------------
+
+/** Input for `browser_navigate`. */
+export interface BrowserNavigateInput {
+  /** Absolute URL to navigate the browser to. */
+  readonly url: string;
+  /**
+   * When to consider navigation complete. Defaults to `load`.
+   * Mirrors Playwright's `waitUntil` states.
+   */
+  readonly waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
+  /** Per-navigation timeout in milliseconds. Defaults to 30000. */
+  readonly timeoutMs?: number;
+}
+
+/** Result common to navigation / interaction browser tools. */
+export interface BrowserPageState {
+  /** The page's current URL after the operation. */
+  readonly url: string;
+  /** The page's `document.title` after the operation. */
+  readonly title: string;
+}
+
+/** Input for `browser_click`. */
+export interface BrowserClickInput {
+  /** A CSS / Playwright selector for the element to click. */
+  readonly selector: string;
+  /** Per-action timeout in milliseconds. Defaults to 15000. */
+  readonly timeoutMs?: number;
+}
+
+/** Input for `browser_type`. */
+export interface BrowserTypeInput {
+  /** A CSS / Playwright selector for the input element. */
+  readonly selector: string;
+  /** The text to type into the element. */
+  readonly text: string;
+  /** Clear the field before typing. Defaults to `true`. */
+  readonly clear?: boolean;
+  /** Per-action timeout in milliseconds. Defaults to 15000. */
+  readonly timeoutMs?: number;
+}
+
+/** Input for `browser_press` (a single key / chord). */
+export interface BrowserPressInput {
+  /**
+   * The key (or `Modifier+Key` chord) to press, in Playwright key syntax
+   * (e.g. `Enter`, `Tab`, `Control+A`, `ArrowDown`).
+   */
+  readonly key: string;
+  /** Optional selector to focus before pressing. */
+  readonly selector?: string;
+  /** Per-action timeout in milliseconds. Defaults to 15000. */
+  readonly timeoutMs?: number;
+}
+
+/** Result of a `browser_click` / `browser_type` / `browser_press` action. */
+export interface BrowserActionResult extends BrowserPageState {
+  /** The action that was performed. */
+  readonly action: 'click' | 'type' | 'press';
+}
+
+/** A single node in the {@link BrowserSnapshotResult} accessibility tree. */
+export interface AccessibilityNode {
+  /** ARIA role (e.g. `button`, `link`, `textbox`). */
+  readonly role: string;
+  /** Accessible name, when present. */
+  readonly name?: string;
+  /** Current value (form controls). */
+  readonly value?: string;
+  /** Child nodes (depth-first). */
+  readonly children?: readonly AccessibilityNode[];
+}
+
+/** Result of `browser_snapshot` — the page accessibility tree. */
+export interface BrowserSnapshotResult extends BrowserPageState {
+  /** The root of the accessibility tree, or `null` when none is available. */
+  readonly tree: AccessibilityNode | null;
+}
+
+/** Scroll direction for `browser_scroll`. */
+export type BrowserScrollDirection = 'up' | 'down';
+
+/** Input for `browser_scroll`. */
+export interface BrowserScrollInput {
+  /** Direction to scroll. */
+  readonly direction: BrowserScrollDirection;
+  /**
+   * Pixels to scroll by. Defaults to roughly one viewport height (800px).
+   */
+  readonly amountPx?: number;
+}
+
+/** Result of `browser_scroll`. */
+export interface BrowserScrollResult extends BrowserPageState {
+  /** The direction that was scrolled. */
+  readonly direction: BrowserScrollDirection;
+  /** The vertical scroll position (pixels from top) after scrolling. */
+  readonly scrollY: number;
+}
+
+/** Input for `browser_vision` (screenshot + AI analysis). */
+export interface BrowserVisionInput {
+  /**
+   * The question / instruction the vision model should answer about the current
+   * page screenshot (e.g. "What is the primary call-to-action on this page?").
+   */
+  readonly prompt: string;
+  /** Capture the full scrollable page rather than just the viewport. Defaults to `false`. */
+  readonly fullPage?: boolean;
+}
+
+/** Result of `browser_vision`. */
+export interface BrowserVisionResult extends BrowserPageState {
+  /**
+   * The vision model's textual analysis of the screenshot, or `null` when no
+   * LLM credential was reachable (graceful degradation — NOT an error).
+   */
+  readonly analysis: string | null;
+  /** The model id that produced {@link BrowserVisionResult.analysis}, when available. */
+  readonly model?: string;
+  /**
+   * `true` when the AI call was skipped because no LLM credential resolved
+   * through the E9 chokepoint. The screenshot was still captured.
+   */
+  readonly aiUnavailable: boolean;
+}

package/dist/tessera.d.ts

@@ -1,32 +0,0 @@
-/**
- * Tessera Type Definitions
- *
- * Tessera templates extend WarpChain with variable bindings,
- * archetype classification, and instantiation inputs for
- * parameterized pipeline creation.
- *
- * @task T5408
- */
-import type { WarpChain } from './warp-chain.js';
-/** A variable declaration within a Tessera template. */
-export interface TesseraVariable {
-    name: string;
-    type: 'string' | 'number' | 'boolean' | 'taskId' | 'epicId';
-    description: string;
-    required: boolean;
-    default?: unknown;
-}
-/** A parameterized WarpChain template with variable bindings. */
-export interface TesseraTemplate extends WarpChain {
-    variables: Record<string, TesseraVariable>;
-    archetypes: string[];
-    defaultValues: Record<string, unknown>;
-    category: 'lifecycle' | 'hotfix' | 'research' | 'security-audit' | 'custom';
-}
-/** Input for instantiating a Tessera template into a concrete chain. */
-export interface TesseraInstantiationInput {
-    templateId: string;
-    epicId: string;
-    variables: Record<string, unknown>;
-}
-//# sourceMappingURL=tessera.d.ts.map

package/dist/tessera.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tessera.d.ts","sourceRoot":"","sources":["../src/tessera.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,gBAAgB,GAAG,QAAQ,CAAC;CAC7E;AAED,wEAAwE;AACxE,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/tessera.js

@@ -1,11 +0,0 @@
-/**
- * Tessera Type Definitions
- *
- * Tessera templates extend WarpChain with variable bindings,
- * archetype classification, and instantiation inputs for
- * parameterized pipeline creation.
- *
- * @task T5408
- */
-export {};
-//# sourceMappingURL=tessera.js.map

package/dist/tessera.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tessera.js","sourceRoot":"","sources":["../src/tessera.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/warp-chain.d.ts

@@ -1,129 +0,0 @@
-/**
- * WarpChain Type System
- *
- * Defines the complete type system for WarpChain workflow definitions.
- * Warp is the unyielding protocol chain: the synthesis of composable workflow
- * shape (topology) and LOOM quality gates into a unified chain model.
- *
- * ProtocolType and GateName are inlined here (contracts has zero external deps).
- *
- * @task T5407
- */
-/**
- * All supported protocol types.
- *
- * Covers the 9 RCASD-IVTR pipeline stages plus the 3 cross-cutting protocols
- * (contribution, artifact-publish, provenance). Must stay in sync with
- * `packages/core/src/orchestration/protocol-validators.ts#PROTOCOL_TYPES`.
- *
- * @task T260 — add architecture-decision, validation, testing
- */
-export type ProtocolType = 'research' | 'consensus' | 'architecture-decision' | 'specification' | 'decomposition' | 'implementation' | 'contribution' | 'validation' | 'testing' | 'release' | 'artifact-publish' | 'provenance';
-/** Verification gate names (ordered dependency chain). */
-export type GateName = 'implemented' | 'testsPassed' | 'qaPassed' | 'cleanupDone' | 'securityPassed' | 'documented';
-/**
- * A single stage in the warp chain.
- *
- * The category union includes all canonical CLEO pipeline stages
- * plus 'custom' for user-defined stages.
- */
-export interface WarpStage {
-    id: string;
-    name: string;
-    category: 'research' | 'consensus' | 'architecture' | 'specification' | 'decomposition' | 'implementation' | 'validation' | 'testing' | 'release' | 'contribution' | 'custom';
-    skippable: boolean;
-    description?: string;
-}
-/** Connection between two stages in the chain. */
-export interface WarpLink {
-    from: string;
-    to: string;
-    type: 'linear' | 'fork' | 'branch';
-    condition?: string;
-}
-/** The topology/DAG of a workflow. */
-export interface ChainShape {
-    stages: WarpStage[];
-    links: WarpLink[];
-    entryPoint: string;
-    exitPoints: string[];
-}
-/** Discriminated union for gate check types. */
-export type GateCheck = {
-    type: 'stage_complete';
-    stageId: string;
-} | {
-    type: 'artifact_exists';
-    artifactType: string;
-    path?: string;
-} | {
-    type: 'protocol_valid';
-    protocolType: ProtocolType;
-} | {
-    type: 'verification_gate';
-    gateName: GateName;
-} | {
-    type: 'custom';
-    validator: string;
-    params?: Record<string, unknown>;
-};
-/** A quality gate embedded in the chain. */
-export interface GateContract {
-    id: string;
-    name: string;
-    type: 'entry' | 'exit' | 'checkpoint';
-    stageId: string;
-    position: 'before' | 'after';
-    check: GateCheck;
-    severity: 'blocking' | 'warning' | 'info';
-    canForce: boolean;
-}
-/** Complete chain definition combining shape and gates. */
-export interface WarpChain {
-    id: string;
-    name: string;
-    version: string;
-    description: string;
-    shape: ChainShape;
-    gates: GateContract[];
-    tessera?: string;
-    metadata?: Record<string, unknown>;
-}
-/** Result of validating a chain definition. */
-export interface ChainValidation {
-    wellFormed: boolean;
-    gateSatisfiable: boolean;
-    artifactComplete: boolean;
-    errors: string[];
-    warnings: string[];
-}
-/** A chain bound to a specific epic. */
-export interface WarpChainInstance {
-    id: string;
-    chainId: string;
-    epicId: string;
-    variables: Record<string, unknown>;
-    stageToTask: Record<string, string>;
-    status: 'pending' | 'active' | 'completed' | 'failed' | 'cancelled';
-    currentStage: string;
-    createdAt: string;
-    createdBy: string;
-}
-/** Result of evaluating a single gate. */
-export interface GateResult {
-    gateId: string;
-    passed: boolean;
-    forced: boolean;
-    message?: string;
-    evaluatedAt: string;
-}
-/** Runtime state of a chain instance execution. */
-export interface WarpChainExecution {
-    instanceId: string;
-    currentStage: string;
-    gateResults: GateResult[];
-    status: 'running' | 'paused' | 'completed' | 'failed';
-    startedAt: string;
-    completedAt?: string;
-}
-//# sourceMappingURL=warp-chain.d.ts.map

package/dist/warp-chain.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"warp-chain.d.ts","sourceRoot":"","sources":["../src/warp-chain.ts"],"names":[],"mappings":"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"}

package/dist/warp-chain.js

@@ -1,13 +0,0 @@
-/**
- * WarpChain Type System
- *
- * Defines the complete type system for WarpChain workflow definitions.
- * Warp is the unyielding protocol chain: the synthesis of composable workflow
- * shape (topology) and LOOM quality gates into a unified chain model.
- *
- * ProtocolType and GateName are inlined here (contracts has zero external deps).
- *
- * @task T5407
- */
-export {};
-//# sourceMappingURL=warp-chain.js.map

package/dist/warp-chain.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"warp-chain.js","sourceRoot":"","sources":["../src/warp-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/src/tessera.ts

@@ -1,35 +0,0 @@
-/**
- * Tessera Type Definitions
- *
- * Tessera templates extend WarpChain with variable bindings,
- * archetype classification, and instantiation inputs for
- * parameterized pipeline creation.
- *
- * @task T5408
- */
-
-import type { WarpChain } from './warp-chain.js';
-
-/** A variable declaration within a Tessera template. */
-export interface TesseraVariable {
-  name: string;
-  type: 'string' | 'number' | 'boolean' | 'taskId' | 'epicId';
-  description: string;
-  required: boolean;
-  default?: unknown;
-}
-
-/** A parameterized WarpChain template with variable bindings. */
-export interface TesseraTemplate extends WarpChain {
-  variables: Record<string, TesseraVariable>;
-  archetypes: string[];
-  defaultValues: Record<string, unknown>;
-  category: 'lifecycle' | 'hotfix' | 'research' | 'security-audit' | 'custom';
-}
-
-/** Input for instantiating a Tessera template into a concrete chain. */
-export interface TesseraInstantiationInput {
-  templateId: string;
-  epicId: string;
-  variables: Record<string, unknown>;
-}

package/src/warp-chain.ts

@@ -1,185 +0,0 @@
-/**
- * WarpChain Type System
- *
- * Defines the complete type system for WarpChain workflow definitions.
- * Warp is the unyielding protocol chain: the synthesis of composable workflow
- * shape (topology) and LOOM quality gates into a unified chain model.
- *
- * ProtocolType and GateName are inlined here (contracts has zero external deps).
- *
- * @task T5407
- */
-
-// =============================================================================
-// INLINED TYPES (from core/orchestration and core/validation)
-// =============================================================================
-
-/**
- * All supported protocol types.
- *
- * Covers the 9 RCASD-IVTR pipeline stages plus the 3 cross-cutting protocols
- * (contribution, artifact-publish, provenance). Must stay in sync with
- * `packages/core/src/orchestration/protocol-validators.ts#PROTOCOL_TYPES`.
- *
- * @task T260 — add architecture-decision, validation, testing
- */
-export type ProtocolType =
-  | 'research'
-  | 'consensus'
-  | 'architecture-decision'
-  | 'specification'
-  | 'decomposition'
-  | 'implementation'
-  | 'contribution'
-  | 'validation'
-  | 'testing'
-  | 'release'
-  | 'artifact-publish'
-  | 'provenance';
-
-/** Verification gate names (ordered dependency chain). */
-export type GateName =
-  | 'implemented'
-  | 'testsPassed'
-  | 'qaPassed'
-  | 'cleanupDone'
-  | 'securityPassed'
-  | 'documented';
-
-// =============================================================================
-// CHAIN SHAPE (Warp topology)
-// =============================================================================
-
-/**
- * A single stage in the warp chain.
- *
- * The category union includes all canonical CLEO pipeline stages
- * plus 'custom' for user-defined stages.
- */
-export interface WarpStage {
-  id: string;
-  name: string;
-  category:
-    | 'research'
-    | 'consensus'
-    | 'architecture'
-    | 'specification'
-    | 'decomposition'
-    | 'implementation'
-    | 'validation'
-    | 'testing'
-    | 'release'
-    | 'contribution'
-    | 'custom';
-  skippable: boolean;
-  description?: string;
-}
-
-/** Connection between two stages in the chain. */
-export interface WarpLink {
-  from: string;
-  to: string;
-  type: 'linear' | 'fork' | 'branch';
-  condition?: string;
-}
-
-/** The topology/DAG of a workflow. */
-export interface ChainShape {
-  stages: WarpStage[];
-  links: WarpLink[];
-  entryPoint: string;
-  exitPoints: string[];
-}
-
-// =============================================================================
-// GATE SYSTEM (LOOM quality gates)
-// =============================================================================
-
-/** Discriminated union for gate check types. */
-export type GateCheck =
-  | { type: 'stage_complete'; stageId: string }
-  | { type: 'artifact_exists'; artifactType: string; path?: string }
-  | { type: 'protocol_valid'; protocolType: ProtocolType }
-  | { type: 'verification_gate'; gateName: GateName }
-  | { type: 'custom'; validator: string; params?: Record<string, unknown> };
-
-/** A quality gate embedded in the chain. */
-export interface GateContract {
-  id: string;
-  name: string;
-  type: 'entry' | 'exit' | 'checkpoint';
-  stageId: string;
-  position: 'before' | 'after';
-  check: GateCheck;
-  severity: 'blocking' | 'warning' | 'info';
-  canForce: boolean;
-}
-
-// =============================================================================
-// CHAIN DEFINITION
-// =============================================================================
-
-/** Complete chain definition combining shape and gates. */
-export interface WarpChain {
-  id: string;
-  name: string;
-  version: string;
-  description: string;
-  shape: ChainShape;
-  gates: GateContract[];
-  tessera?: string;
-  metadata?: Record<string, unknown>;
-}
-
-// =============================================================================
-// CHAIN VALIDATION
-// =============================================================================
-
-/** Result of validating a chain definition. */
-export interface ChainValidation {
-  wellFormed: boolean;
-  gateSatisfiable: boolean;
-  artifactComplete: boolean;
-  errors: string[];
-  warnings: string[];
-}
-
-// =============================================================================
-// CHAIN INSTANCE (runtime binding)
-// =============================================================================
-
-/** A chain bound to a specific epic. */
-export interface WarpChainInstance {
-  id: string;
-  chainId: string;
-  epicId: string;
-  variables: Record<string, unknown>;
-  stageToTask: Record<string, string>;
-  status: 'pending' | 'active' | 'completed' | 'failed' | 'cancelled';
-  currentStage: string;
-  createdAt: string;
-  createdBy: string;
-}
-
-// =============================================================================
-// CHAIN EXECUTION (runtime state)
-// =============================================================================
-
-/** Result of evaluating a single gate. */
-export interface GateResult {
-  gateId: string;
-  passed: boolean;
-  forced: boolean;
-  message?: string;
-  evaluatedAt: string;
-}
-
-/** Runtime state of a chain instance execution. */
-export interface WarpChainExecution {
-  instanceId: string;
-  currentStage: string;
-  gateResults: GateResult[];
-  status: 'running' | 'paused' | 'completed' | 'failed';
-  startedAt: string;
-  completedAt?: string;
-}