@pome-sh/cli 0.2.0 → 0.4.0

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/mcp-jsonrpc.js

@@ -0,0 +1,221 @@
+// SPDX-License-Identifier: Apache-2.0
+//
+// Streamable-HTTP JSON-RPC 2.0 MCP endpoint (`POST /s/:sid/mcp`), stateless
+// mode: GET/DELETE answer 405. Generic over the twin's ToolSpec registry —
+// the per-twin mcp.ts modules this replaces differed only in their tool
+// tables and error envelopes, both of which now come from the manifest.
+import { randomUUID } from "node:crypto";
+import { toolInputSchema, toolListExtras, } from "./index.js";
+import { UnknownToolError, envelopeFor } from "./errors.js";
+import { makeToolCallContext } from "./tool-context.js";
+const PARSE_ERROR = -32700;
+const INVALID_REQUEST = -32600;
+const METHOD_NOT_FOUND = -32601;
+const INVALID_PARAMS = -32602;
+const INTERNAL_ERROR = -32603;
+const DEFAULT_PROTOCOL_VERSION = "2025-06-18";
+const SUPPORTED_PROTOCOL_VERSIONS = new Set(["2024-11-05", "2025-03-26", "2025-06-18"]);
+export function mcpMethodNotAllowed(c) {
+    return c.json({ jsonrpc: "2.0", id: null, error: { code: METHOD_NOT_FOUND, message: "Method not allowed in stateless mode" } }, 405, { Allow: "POST" });
+}
+export async function handleMcpJsonRpc(c, deps) {
+    let body;
+    try {
+        body = await c.req.json();
+    }
+    catch {
+        return jsonRpcErrorResponse(null, PARSE_ERROR, "Problems parsing JSON");
+    }
+    if (Array.isArray(body)) {
+        if (body.length === 0) {
+            return jsonRpcErrorResponse(null, INVALID_REQUEST, "Invalid Request");
+        }
+        const out = [];
+        for (const message of body) {
+            const response = await dispatch(message, deps, c);
+            if (response)
+                out.push(response);
+        }
+        if (out.length === 0)
+            return new Response(null, { status: 202 });
+        return Response.json(out, { status: 200, headers: { "content-type": "application/json" } });
+    }
+    const response = await dispatch(body, deps, c);
+    if (!response)
+        return new Response(null, { status: 202 });
+    return Response.json(response, { status: 200, headers: { "content-type": "application/json" } });
+}
+async function dispatch(message, deps, c) {
+    if (!isObject(message))
+        return errorEnvelope(null, INVALID_REQUEST, "Invalid Request");
+    if (message.jsonrpc !== "2.0" || typeof message.method !== "string") {
+        return errorEnvelope(idOf(message), INVALID_REQUEST, "Invalid Request");
+    }
+    const method = message.method;
+    const params = isObject(message.params) ? message.params : {};
+    const rawId = message.id;
+    if (rawId === undefined || rawId === null)
+        return null; // notification
+    if (typeof rawId !== "string" && typeof rawId !== "number") {
+        return errorEnvelope(null, INVALID_REQUEST, "Invalid Request: id must be string or number");
+    }
+    const id = rawId;
+    try {
+        switch (method) {
+            case "initialize":
+                return { jsonrpc: "2.0", id, result: buildInitializeResult(params, deps.definition) };
+            case "ping":
+                return { jsonrpc: "2.0", id, result: {} };
+            case "tools/list":
+                return {
+                    jsonrpc: "2.0",
+                    id,
+                    result: {
+                        tools: deps.definition.tools.map((tool) => ({
+                            name: tool.name,
+                            description: tool.description,
+                            inputSchema: toolInputSchema(tool),
+                            ...toolListExtras(tool),
+                        })),
+                    },
+                };
+            case "tools/call":
+                return await handleToolsCall(id, params, deps, c);
+            default:
+                return errorEnvelope(id, METHOD_NOT_FOUND, `Method not found: ${method}`);
+        }
+    }
+    catch (err) {
+        return errorEnvelope(id, INTERNAL_ERROR, err instanceof Error ? err.message : "Internal error");
+    }
+}
+function buildInitializeResult(params, definition) {
+    const requested = typeof params.protocolVersion === "string" ? params.protocolVersion : undefined;
+    const protocolVersion = requested && SUPPORTED_PROTOCOL_VERSIONS.has(requested) ? requested : DEFAULT_PROTOCOL_VERSION;
+    return {
+        protocolVersion,
+        capabilities: { tools: { listChanged: false } },
+        serverInfo: { name: `twin-${definition.id}`, version: definition.version },
+    };
+}
+async function handleToolsCall(id, params, deps, c) {
+    const name = params.name;
+    const args = params.arguments === undefined || params.arguments === null
+        ? {}
+        : isObject(params.arguments)
+            ? params.arguments
+            : undefined;
+    if (typeof name !== "string" || name.length === 0 || args === undefined) {
+        return errorEnvelope(id, INVALID_PARAMS, "Invalid params: expected { name: string, arguments?: object }");
+    }
+    const projectError = deps.definition.errorEnvelope ?? envelopeFor;
+    const tool = deps.definition.tools.find((t) => t.name === name);
+    const started = Date.now();
+    const call = makeToolCallContext(c);
+    let status;
+    let responseBody;
+    let toolError = null;
+    let mutation = false;
+    let mcpResult;
+    if (!tool) {
+        const envelope = projectError(new UnknownToolError(name));
+        // The unknown-tool result body is frozen per twin (F-682): github pins
+        // its pre-port `{message: "Unknown tool: <name>"}` text while the
+        // legacy /mcp/call surface keeps the envelope projection.
+        const body = deps.definition.mcpUnknownTool ? deps.definition.mcpUnknownTool(name) : envelope.body;
+        status = envelope.status;
+        responseBody = body;
+        toolError = `Unknown tool: ${name}`;
+        mcpResult = { content: [{ type: "text", text: JSON.stringify(body) }], isError: true };
+    }
+    else {
+        try {
+            const parsed = tool.schema.parse(args);
+            const value = await tool.handler(deps.domain, parsed, call.ctx);
+            status = 200;
+            responseBody = value;
+            mutation = tool.mutation;
+            // Only tools that declare `outputSchema` get `structuredContent` —
+            // existing twins omit both and stay byte-identical on the wire.
+            mcpResult = {
+                content: [
+                    {
+                        type: "text",
+                        text: tool.contentText ? tool.contentText(value) : JSON.stringify(value),
+                    },
+                ],
+                ...(tool.outputSchema !== undefined ? { structuredContent: value } : {}),
+                ...(tool.includeIsError ? { isError: false } : {}),
+            };
+        }
+        catch (err) {
+            const envelope = projectError(err);
+            status = envelope.status;
+            responseBody = envelope.body;
+            toolError = err instanceof Error ? err.message : "tool call failed";
+            mcpResult = { content: [{ type: "text", text: JSON.stringify(envelope.body) }], isError: true };
+        }
+    }
+    const delta = status < 400 ? call.delta() : null;
+    // Align with REST rest-routes-kit: when a handler reports reportDelta(null)
+    // (no-op mutation), state_mutation must be false. Twins that never call
+    // reportDelta keep ToolSpec.mutation as the recorder truth.
+    const effectiveMutation = status < 400 && mutation && (!call.reportedDelta() || delta !== null);
+    deps.recorder.record(buildEventCore(c, deps, {
+        started,
+        status,
+        requestBody: { tool: name, arguments: args },
+        responseBody,
+        mutation: effectiveMutation,
+        delta,
+        error: toolError,
+    }));
+    return { jsonrpc: "2.0", id, result: mcpResult };
+}
+function buildEventCore(c, deps, fields) {
+    const requestId = `req_${randomUUID()}`;
+    // Same stamping as recorder.ts emit() — see the comment there (F-683).
+    const stepId = c.req.header("x-pome-scenario-step-id") ?? null;
+    const correlationHeader = c.req.header("x-pome-correlation-id") ?? null;
+    return {
+        ts: new Date().toISOString(),
+        run_id: deps.runId,
+        twin: deps.definition.id,
+        request_id: requestId,
+        correlation_id: correlationHeader ?? requestId,
+        task_step_id: stepId,
+        scenario_step_id: stepId,
+        step_id: null,
+        // FDRS-402 adapter-rich path — per-twin pin, see recorder.ts (F-682).
+        tool_call_id: deps.definition.stampToolCallId ? correlationHeader : null,
+        method: c.req.method,
+        path: new URL(c.req.url).pathname,
+        request_body: fields.requestBody,
+        status: fields.status,
+        response_body: fields.responseBody,
+        latency_ms: Date.now() - fields.started,
+        fidelity: "semantic",
+        state_mutation: fields.mutation,
+        state_delta: fields.delta,
+        error: fields.error,
+    };
+}
+function errorEnvelope(id, code, message) {
+    return { jsonrpc: "2.0", id, error: { code, message } };
+}
+function jsonRpcErrorResponse(id, code, message) {
+    return Response.json(errorEnvelope(id, code, message), {
+        status: 200,
+        headers: { "content-type": "application/json" },
+    });
+}
+function idOf(message) {
+    const id = message.id;
+    if (typeof id === "string" || typeof id === "number")
+        return id;
+    return null;
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=mcp-jsonrpc.js.map

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/mcp-jsonrpc.js.map

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

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/parity.d.ts

@@ -0,0 +1,61 @@
+import { type FidelityInventory } from "./fidelity-inventory.js";
+export type ParityState = Record<string, unknown>;
+export interface ParityStep {
+    tool: string;
+    arguments?: Record<string, unknown> | ((state: ParityState) => Record<string, unknown>);
+    /** Pull cross-call state (ids, numbers, shas) out of the response body. */
+    capture?: (body: unknown, state: ParityState) => void;
+    /** Expected HTTP status; default: any 2xx. */
+    status?: number;
+    /** Extra body assertion; return a problem string to fail the step. */
+    verify?: (body: unknown) => string | undefined;
+}
+export interface ParityRestProbe {
+    /** Label in the report, e.g. "unsupported-rest". */
+    surface: string;
+    method?: string;
+    /** Session-relative path, e.g. "/repos/acme/api/actions/runs". */
+    path: string;
+    /** Expected HTTP status. */
+    status: number;
+    /** Assert the body carries a `fidelity: "unsupported"` marker. */
+    expectUnsupportedEnvelope?: boolean;
+    /** Optional request body for mutating probes (e.g. messages.send). */
+    body?: string;
+    /** Extra request headers (authorization is always set by the runner). */
+    headers?: Record<string, string>;
+    /** Extra body assertion; return a problem string to fail the probe. */
+    verify?: (body: unknown) => string | undefined;
+}
+export interface ParityAppLike {
+    request(path: string | Request, init?: RequestInit): Response | Promise<Response>;
+}
+export interface RunParityOptions {
+    app: ParityAppLike;
+    twin: string;
+    inventory: FidelityInventory;
+    /** `listTools()` names from the twin source — the code truth. */
+    liveToolNames: string[];
+    steps: ParityStep[];
+    restProbes?: ParityRestProbe[];
+    /** Session id; default "fidelity-parity". */
+    sid?: string;
+    /** JWT secret; default env TWIN_AUTH_SECRET or the engine dev secret. */
+    secret?: string;
+    /** Extra JWT claims (login, team_id, account_id, ...). */
+    claims?: Record<string, unknown>;
+    /** Applied to every step without its own `verify` (twin error envelopes). */
+    stepVerify?: (body: unknown) => string | undefined;
+    /** Optional live upstream probes; entries are appended to the report. */
+    live?: () => Promise<unknown[]>;
+}
+export interface ParityResult {
+    ok: boolean;
+    failures: string[];
+    report: unknown[];
+}
+export declare function runFidelityParity(options: RunParityOptions): Promise<ParityResult>;
+/** Script entrypoint: run, print the JSON report, set the exit code. */
+export declare function runParityCli(options: RunParityOptions): Promise<ParityResult>;
+export { compareToolNames, expandSurfaceCell, fidelityDocDriftSchema, fidelityInventorySchema, fidelitySurfaceSchema, heatTierSchema, lintFidelityInventory, loadFidelityInventory, parseFidelityDocRows, } from "./fidelity-inventory.js";
+export type { FidelityDocDrift, FidelityDocRow, FidelityDocSource, FidelityInventory, FidelitySurface, HeatTier, } from "./fidelity-inventory.js";

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/parity.js

@@ -0,0 +1,123 @@
+// SPDX-License-Identifier: Apache-2.0
+//
+// Shared fidelity:parity runner (F-730). One engine-level runner; each twin
+// supplies declarative scenario data — an ordered, stateful chain of MCP
+// calls with cross-call captures (a PR number, a charge id, a message ts) —
+// plus its structured fidelity inventory. No per-twin runner copies (M1
+// "twin-infra copies: 0" gate).
+//
+// The runner asserts three rings agree before it reports green:
+//   1. live tool list (code truth from listTools())
+//   2. fidelity.inventory.json tools (the machine-readable inventory)
+//   3. scenario step coverage (every inventory tool exercised)
+// and that every step answers its expected status through the frozen
+// `POST /s/:sid/mcp/call` surface. Optional REST probes pin the loud-501
+// unsupported envelope; an optional `live` hook lets a twin compare
+// read-only shapes against the real upstream (e.g. `gh api`).
+import { sign } from "hono/jwt";
+import { compareToolNames, } from "./fidelity-inventory.js";
+function bodyKeys(body) {
+    if (Array.isArray(body))
+        return ["array"];
+    if (body && typeof body === "object") {
+        return Object.keys(body).sort();
+    }
+    return [];
+}
+export async function runFidelityParity(options) {
+    const sid = options.sid ?? "fidelity-parity";
+    const secret = options.secret ?? process.env.TWIN_AUTH_SECRET ?? "dev-only-insecure-secret";
+    const token = await sign({ sid, exp: Math.floor(Date.now() / 1000) + 3600, ...options.claims }, secret);
+    const base = `/s/${sid}`;
+    const failures = [];
+    const report = [];
+    // Ring 1 ⇔ ring 2: inventory tools must equal the live tool list.
+    const inventoryNames = options.inventory.tools.map((entry) => entry.name);
+    const inventoryDiff = compareToolNames(inventoryNames, options.liveToolNames);
+    for (const name of inventoryDiff.missing) {
+        failures.push(`tool '${name}' is live in listTools() but missing from fidelity.inventory.json`);
+    }
+    for (const name of inventoryDiff.extra) {
+        failures.push(`tool '${name}' is in fidelity.inventory.json but not in listTools()`);
+    }
+    // Ring 2 ⇔ ring 3: every inventory tool needs at least one scenario step.
+    const covered = new Set(options.steps.map((step) => step.tool));
+    for (const name of inventoryNames) {
+        if (!covered.has(name))
+            failures.push(`no parity scenario step covers tool '${name}'`);
+    }
+    for (const tool of covered) {
+        if (!inventoryNames.includes(tool)) {
+            failures.push(`scenario step calls '${tool}' which is not in fidelity.inventory.json`);
+        }
+    }
+    const state = {};
+    for (const step of options.steps) {
+        const args = typeof step.arguments === "function" ? step.arguments(state) : step.arguments ?? {};
+        const response = await options.app.request(`${base}/mcp/call`, {
+            method: "POST",
+            headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
+            body: JSON.stringify({ tool: step.tool, arguments: args }),
+        });
+        const body = await response.json().catch(() => ({}));
+        const expected = step.status === undefined ? response.ok : response.status === step.status;
+        if (!expected) {
+            failures.push(`${step.tool}: expected ${step.status ?? "2xx"}, got ${response.status} ${JSON.stringify(body).slice(0, 300)}`);
+        }
+        else {
+            const problem = (step.verify ?? options.stepVerify)?.(body);
+            if (problem)
+                failures.push(`${step.tool}: ${problem}`);
+            step.capture?.(body, state);
+        }
+        report.push({ tool: step.tool, status: response.status, ok: response.ok, keys: bodyKeys(body) });
+    }
+    for (const probe of options.restProbes ?? []) {
+        const headers = {
+            authorization: `Bearer ${token}`,
+            ...probe.headers,
+        };
+        if (probe.body !== undefined && !headers["content-type"] && !headers["Content-Type"]) {
+            headers["content-type"] = "application/json";
+        }
+        const response = await options.app.request(`${base}${probe.path}`, {
+            method: probe.method ?? "GET",
+            headers,
+            ...(probe.body !== undefined ? { body: probe.body } : {}),
+        });
+        const body = await response.json().catch(() => ({}));
+        if (response.status !== probe.status) {
+            failures.push(`${probe.surface}: expected ${probe.status}, got ${response.status}`);
+        }
+        if (probe.expectUnsupportedEnvelope && !JSON.stringify(body).includes('"fidelity":"unsupported"')) {
+            failures.push(`${probe.surface}: body does not carry the fidelity:"unsupported" envelope`);
+        }
+        const problem = probe.verify?.(body);
+        if (problem)
+            failures.push(`${probe.surface}: ${problem}`);
+        report.push({ surface: probe.surface, status: response.status, body });
+    }
+    if (options.live) {
+        report.push(...(await options.live()));
+    }
+    return { ok: failures.length === 0, failures, report };
+}
+/** Script entrypoint: run, print the JSON report, set the exit code. */
+export async function runParityCli(options) {
+    const result = await runFidelityParity(options);
+    console.log(JSON.stringify({
+        twin: options.twin,
+        tools: options.inventory.tools.length,
+        rest_surfaces: options.inventory.rest.length,
+        ok: result.ok,
+        failures: result.failures,
+        report: result.report,
+    }, null, 2));
+    if (!result.ok) {
+        console.error(`fidelity:parity FAILED for ${options.twin} (${result.failures.length} problem(s))`);
+        process.exitCode = 1;
+    }
+    return result;
+}
+export { compareToolNames, expandSurfaceCell, fidelityDocDriftSchema, fidelityInventorySchema, fidelitySurfaceSchema, heatTierSchema, lintFidelityInventory, loadFidelityInventory, parseFidelityDocRows, } from "./fidelity-inventory.js";
+//# sourceMappingURL=parity.js.map

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/parity.js.map

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

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/recorder.d.ts

@@ -0,0 +1,120 @@
+import type { RecorderEvent, TwinId } from "@pome-sh/shared-types";
+import type { RecorderHandle } from "./index.js";
+/**
+ * Projects a thrown error into the `{ status, body }` shape a route returns.
+ * Twin authors override this via `TwinDefinition.errorEnvelope` to preserve
+ * the upstream API's error shape (Stripe nests under `{ error: {...} }`;
+ * GitHub uses `{ message, documentation_url, errors[] }`; etc).
+ */
+export type ErrorEnvelopeFn = (err: unknown) => {
+    status: number;
+    body: unknown;
+};
+/**
+ * Backing store for the twin-core recorder.
+ *
+ * `record` / `events` are required. `flush` / `close` are optional so existing
+ * in-memory callers stay source-compatible; durable stores implement them.
+ */
+export interface RecorderStore {
+    record(event: RecorderEvent): void;
+    events(): RecorderEvent[];
+    /** Event count without the O(N) copy `events()` makes. Optional for custom stores. */
+    count?(): number;
+    /** Events dropped by a bounded store (stripe pins a 10k cap + dropped counter). */
+    dropped?(): number;
+    /**
+     * Durability barrier. Resolves when every previously accepted event is on
+     * the backing medium. Optional for heap-only stores.
+     */
+    flush?(): Promise<void>;
+    /**
+     * Flush + release. Idempotent. Optional for heap-only stores.
+     */
+    close?(): Promise<void>;
+}
+export interface RecorderStoreOptions {
+    /**
+     * Bound the in-memory tape: past `maxEvents` the store drops the OLDEST
+     * event and increments the `dropped()` counter (stripe's pre-port
+     * D-ENG-10/E-10 recorder behavior). Default: unbounded (github/slack).
+     * For file-backed stores this does **not** truncate the NDJSON tape —
+     * durability stays append-only; only `events()` is capped.
+     */
+    maxEvents?: number;
+}
+export declare function createRecorderStore(options?: RecorderStoreOptions): RecorderStore;
+export interface FileBackedRecorderStoreOptions extends RecorderStoreOptions {
+    /**
+     * Path to the NDJSON tape (typically a run's `events.jsonl` or a sidecar).
+     * Parent directories are created if missing. Opens append-mode.
+     */
+    path: string;
+    /**
+     * When true, each accepted write is `fsync`'d so a `kill -9` loses at most
+     * the in-flight event. Default true for the production durable path (F-698).
+     */
+    fsync?: boolean;
+}
+/**
+ * Env key for the durable recorder tape. When set, twin boot paths and the
+ * self-host harness use `createFileBackedRecorderStore` instead of heap-only.
+ * Architecture (F-698 / §9 Q3): recorder *transport* lives in twin-core
+ * (`packages/sdk`); twins inherit durability by reading this env.
+ */
+export declare const POME_RECORDER_EVENTS_PATH = "POME_RECORDER_EVENTS_PATH";
+/**
+ * Wrap a legacy `RecorderEvent` into the unified `TwinHttpEvent` NDJSON row
+ * shape used by uploaded `events.jsonl` (FDRS-398). Pass-through only when
+ * `kind` is already `"TwinHttpEvent"`; any other kind is re-wrapped so the
+ * durable tape never persists a mismatched discriminator. Disk rows from the
+ * durable store use this shape so finalize/upload does not need a second wrap
+ * for crash-streamed events.
+ */
+export declare function toTwinHttpEventRow(event: RecorderEvent): RecorderEvent & {
+    kind: "TwinHttpEvent";
+    event_id: string;
+    parent_id: null;
+};
+/**
+ * Durable recorder store (F-720 contract / F-698 implementation).
+ *
+ * Keeps an in-memory mirror of legacy `RecorderEvent` rows for `events()` /
+ * `GET /_pome/events` (unchanged API), and appends each accepted event as a
+ * `TwinHttpEvent` NDJSON line so on-disk `events.jsonl` matches the uploaded
+ * raw-trace byte shape. `flush()` drains pending writes and rethrows the
+ * first append/fsync failure; `fsync` (default true) bounds crash loss to
+ * the in-flight event. `maxEvents` caps only the heap mirror — the NDJSON
+ * tape stays append-only.
+ */
+export declare function createFileBackedRecorderStore(options: FileBackedRecorderStoreOptions): RecorderStore;
+/**
+ * Resolve the recorder store for a twin boot: durable file-backed when
+ * `POME_RECORDER_EVENTS_PATH` is set, otherwise the in-memory default.
+ */
+export declare function resolveRecorderStore(options?: RecorderStoreOptions): RecorderStore;
+export interface RecorderHandleOptions {
+    runId: string;
+    twin: TwinId;
+    store?: RecorderStore;
+    /**
+     * Projects thrown errors into a route response. Defaults to the generic
+     * `{ message, errors? }` envelope; the SDK's `createApp` forwards
+     * `definition.errorEnvelope` here so API-mirroring twins control their
+     * own error shape without bypassing the recorder middleware.
+     */
+    errorEnvelope?: ErrorEnvelopeFn;
+    /**
+     * FDRS-402 adapter-rich stamping pin (F-682): when true, events persist
+     * the incoming `x-pome-correlation-id` header as `tool_call_id` (github's
+     * frozen tape shape). Default false — slack's frozen tape stamps null.
+     */
+    stampToolCallId?: boolean;
+    /**
+     * Optional pre-redaction projection (from `TwinDefinition.recordingProjection`).
+     * Runs before `redactEvent` so twins can replace raw payloads with digests
+     * without bypassing the secret scrubber. Unset = no-op (existing twins).
+     */
+    recordingProjection?: (event: RecorderEvent) => RecorderEvent;
+}
+export declare function createRecorderHandle(options: RecorderHandleOptions): RecorderHandle;