@intentface/latch-core 0.9.1

package/dist/harness/tools.d.ts

@@ -0,0 +1,88 @@
+import type { Tool } from "ai";
+import type { Runtime } from "../runtime.js";
+/**
+ * The default harness tools — what every host used to copy from the platform:
+ *
+ *  - sandbox: `bash` / `read_file` / `write_file` / `glob` / `grep`, thin
+ *    wrappers over the AI SDK's `Experimental_SandboxSession` (read from
+ *    `options.experimental_sandbox`, resolved per turn by `RuntimeConfig.sandbox`).
+ *  - app: `web_fetch` (clean markdown/text, images/PDFs as viewable media,
+ *    SSRF-gated, DNS-pinned), `askUser` (client-handled pause for a
+ *    multiple-choice question), `list_schedules` / `cancel_schedule` (over the
+ *    runtime the turn is running in — every tool receives it as
+ *    `options.context.runtime`).
+ *
+ * `web_fetch` is the only tool with dependencies beyond `ai`: `turndown` and
+ * `@intentface/latch-net` are OPTIONAL peers of core, imported lazily on first
+ * call, so a host that never grants `web_fetch` never loads them.
+ */
+/** The model-facing tool-result shape (`ai` doesn't re-export it directly). */
+type ToolResultOutput = Awaited<ReturnType<NonNullable<Tool["toModelOutput"]>>>;
+/**
+ * What the runtime puts on `options.context` for every tool (see
+ * `buildTurn`'s toolsContext): the host's runtime context, the principal, the
+ * run, the writer — and the runtime itself.
+ */
+export interface HarnessToolContext<P = unknown> {
+    principal: P;
+    run?: {
+        id: string;
+        chatId: string;
+        agent: string;
+    };
+    runtime?: Runtime<P>;
+}
+export declare const harnessContextOf: <P = unknown>(o: unknown) => HarnessToolContext<P>;
+/** Keep the tail of long output (errors/results usually land at the end). */
+export declare function tail(text: string, maxLines?: number, maxBytes?: number): {
+    text: string;
+    truncated: boolean;
+};
+/** web_fetch's stored output — text page, fetched media, or an error. */
+export type WebFetchToolOutput = {
+    ok: true;
+    kind?: "text";
+    status: number;
+    contentType: string;
+    body: string;
+    truncated: boolean;
+} | {
+    ok: true;
+    kind: "media";
+    status: number;
+    contentType: string;
+    mediaType: string;
+    /** Base64 bytes — surfaced to the model as an image/document block. */
+    data: string;
+    bytes: number;
+    url: string;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * What the model sees of a web_fetch result. Media becomes a real file block —
+ * an image the model can look at, a PDF Anthropic renders as a document — with
+ * a text line alongside so providers that can't take media in tool results
+ * still leave the model oriented instead of staring at a silently-emptied
+ * result. Text results keep the default JSON view.
+ */
+export declare function webFetchToModelOutput({ output }: {
+    output: unknown;
+}): ToolResultOutput;
+/** Sandbox-backed tools (need an agent with `sandbox: true`). */
+export declare const sandboxTools: Record<string, unknown>;
+/** App-process default tools (granted by `defaultTools`; no sandbox needed). */
+export declare const appTools: Record<string, unknown>;
+/**
+ * The `RuntimeConfig.harnessTools` bundle: sandbox + app tools, no default
+ * approval gates (nothing here persists a side effect the user hasn't asked
+ * for in the turn). Spread a host's own additions over `app` / `approval`.
+ */
+export declare function defaultHarnessTools(): {
+    sandbox: Record<string, unknown>;
+    app: Record<string, unknown>;
+    approval: Record<string, unknown>;
+};
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/harness/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/harness/tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA+B,IAAI,EAAE,MAAM,IAAI,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C;;;;;;;;;;;;;;;GAeG;AAEH,+EAA+E;AAC/E,KAAK,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAUhF;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,SAAS,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACtB;AACD,eAAO,MAAM,gBAAgB,GAAI,CAAC,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,kBAAkB,CAAC,CAAC,CACM,CAAC;AAKtF,6EAA6E;AAC7E,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAM,EAAE,QAAQ,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAa1G;AAyGD,yEAAyE;AACzE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAClG;IACE,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AASjC;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,gBAAgB,CAYvF;AA8JD,iEAAiE;AACjE,eAAO,MAAM,YAAY,EAAkD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACnG,gFAAgF;AAChF,eAAO,MAAM,QAAQ,EAA8D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3G;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI;IACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAEA"}

package/dist/harness/tools.js

@@ -0,0 +1,296 @@
+import { tool, jsonSchema } from "ai";
+const sandboxOf = (o) => {
+    const s = o.experimental_sandbox;
+    if (!s)
+        throw new Error("No sandbox available for this turn.");
+    return s;
+};
+export const harnessContextOf = (o) => o.context ?? {};
+/** Single-quote a value for safe interpolation into a shell command. */
+const q = (s) => `'${s.replace(/'/g, `'\\''`)}'`;
+/** Keep the tail of long output (errors/results usually land at the end). */
+export function tail(text, maxLines = 400, maxBytes = 20_000) {
+    let out = text;
+    let truncated = false;
+    const lines = out.split("\n");
+    if (lines.length > maxLines) {
+        out = lines.slice(-maxLines).join("\n");
+        truncated = true;
+    }
+    if (Buffer.byteLength(out) > maxBytes) {
+        out = out.slice(-maxBytes);
+        truncated = true;
+    }
+    return { text: out, truncated };
+}
+// ── Sandbox tools ───────────────────────────────────────────────────────────
+const bash = tool({
+    description: "Run a shell command in the sandbox workspace (cwd /workspace). Use for " +
+        "listing, moving, inspecting, and combining files with pipes. Depending " +
+        "on the sandbox backend, the root may also hold READ-ONLY mounts of " +
+        "connected services — run `ls /` to discover them and browse with " +
+        "ls/cat/grep. Output is tail-truncated if very long.",
+    inputSchema: jsonSchema({
+        type: "object",
+        properties: { command: { type: "string", description: "Shell command to run." } },
+        required: ["command"],
+        additionalProperties: false,
+    }),
+    execute: async ({ command }, options) => {
+        const r = await sandboxOf(options).run({ command });
+        const so = tail(r.stdout);
+        const se = tail(r.stderr);
+        return { exitCode: r.exitCode, stdout: so.text, stderr: se.text, truncated: so.truncated || se.truncated };
+    },
+});
+const read_file = tool({
+    description: "Read a text file from the sandbox, returned with 1-based line numbers. " +
+        "Optionally restrict to a line range. Read before you write.",
+    inputSchema: jsonSchema({
+        type: "object",
+        properties: {
+            path: { type: "string" },
+            start_line: { type: "number", description: "1-based inclusive start line." },
+            end_line: { type: "number", description: "1-based inclusive end line." },
+        },
+        required: ["path"],
+        additionalProperties: false,
+    }),
+    execute: async ({ path, start_line, end_line }, options) => {
+        const text = await sandboxOf(options).readTextFile({ path, startLine: start_line, endLine: end_line });
+        if (text == null)
+            return { found: false };
+        const start = start_line ?? 1;
+        const numbered = text
+            .split("\n")
+            .map((l, i) => `${start + i}\t${l}`)
+            .join("\n");
+        return { found: true, content: numbered };
+    },
+});
+const write_file = tool({
+    description: "Write a complete file to the sandbox (overwrites; creates parent dirs). " +
+        "Prefer reading the file first when editing an existing one.",
+    inputSchema: jsonSchema({
+        type: "object",
+        properties: { path: { type: "string" }, content: { type: "string" } },
+        required: ["path", "content"],
+        additionalProperties: false,
+    }),
+    execute: async ({ path, content }, options) => {
+        await sandboxOf(options).writeTextFile({ path, content });
+        return { ok: true, bytes: Buffer.byteLength(content) };
+    },
+});
+const glob = tool({
+    description: "Find files by name pattern (recursively from a directory, default the " +
+        "workspace root). Pattern matches the file name, e.g. '*.ts'.",
+    inputSchema: jsonSchema({
+        type: "object",
+        properties: { pattern: { type: "string" }, path: { type: "string" } },
+        required: ["pattern"],
+        additionalProperties: false,
+    }),
+    execute: async ({ pattern, path }, options) => {
+        const r = await sandboxOf(options).run({ command: `find ${q(path ?? ".")} -type f -name ${q(pattern)}` });
+        const files = r.stdout.split("\n").map((s) => s.trim()).filter(Boolean);
+        return { files: files.slice(0, 500), truncated: files.length > 500 };
+    },
+});
+const grep = tool({
+    description: "Search file contents by regex in the sandbox (ripgrep), returning " +
+        "file:line:match. Searches the workspace root by default.",
+    inputSchema: jsonSchema({
+        type: "object",
+        properties: { pattern: { type: "string" }, path: { type: "string" } },
+        required: ["pattern"],
+        additionalProperties: false,
+    }),
+    execute: async ({ pattern, path }, options) => {
+        // Plain `rg <pattern> <path>` already emits file:line:match.
+        const r = await sandboxOf(options).run({ command: `rg ${q(pattern)} ${q(path ?? ".")}` });
+        // rg exits 1 when there are no matches — that's not an error.
+        const { text, truncated } = tail(r.stdout);
+        return { matches: text, truncated, noMatches: r.exitCode === 1 && !r.stdout };
+    },
+});
+/** Human-readable size — never "0 KB" for a real payload. */
+function formatBytes(n) {
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1024 * 1024)
+        return `${Math.round(n / 1024)} KB`;
+    return `${(n / (1024 * 1024)).toFixed(1)} MB`;
+}
+/**
+ * What the model sees of a web_fetch result. Media becomes a real file block —
+ * an image the model can look at, a PDF Anthropic renders as a document — with
+ * a text line alongside so providers that can't take media in tool results
+ * still leave the model oriented instead of staring at a silently-emptied
+ * result. Text results keep the default JSON view.
+ */
+export function webFetchToModelOutput({ output }) {
+    const r = output;
+    if (r && typeof r === "object" && r.ok && r.kind === "media") {
+        return {
+            type: "content",
+            value: [
+                { type: "text", text: `Fetched ${r.mediaType} (${formatBytes(r.bytes)}) from ${r.url}:` },
+                { type: "file", mediaType: r.mediaType, data: { type: "data", data: r.data } },
+            ],
+        };
+    }
+    return { type: "json", value: output };
+}
+/** Lazy: `turndown` + `@intentface/latch-net` load on first use, never at import. */
+let webFetchImpl;
+const loadWebFetch = () => (webFetchImpl ??= import("./web-fetch.js").then((m) => m.webFetch).catch((e) => {
+    webFetchImpl = undefined;
+    throw new Error(`web_fetch needs its optional peers installed (turndown, @intentface/latch-net): ${e instanceof Error ? e.message : String(e)}`);
+}));
+const web_fetch = tool({
+    description: "Fetch a public http(s) URL and return its content. HTML is converted to " +
+        "clean markdown (default) or text — not raw markup — so it's compact and " +
+        "readable. Images (png/jpeg/gif/webp) and PDFs are returned as viewable " +
+        "attachments — you SEE them, not their bytes. Runs in the app, not the " +
+        "sandbox; private/loopback hosts blocked.",
+    inputSchema: jsonSchema({
+        type: "object",
+        properties: {
+            url: { type: "string", description: "Fully-formed http(s) URL to fetch." },
+            format: {
+                type: "string",
+                enum: ["markdown", "text", "html"],
+                description: 'Output format; HTML is converted to it. Defaults to "markdown".',
+            },
+            timeout: { type: "number", minimum: 0, description: "Timeout in seconds (default 30, max 120)." },
+        },
+        required: ["url"],
+        additionalProperties: false,
+    }),
+    execute: async ({ url, format, timeout }) => {
+        const webFetch = await loadWebFetch();
+        const r = await webFetch({ url, format, timeout });
+        if (!r.ok)
+            return { ok: false, error: r.error };
+        if (r.kind === "media") {
+            return {
+                ok: true,
+                kind: "media",
+                status: r.status,
+                contentType: r.contentType,
+                mediaType: r.mediaType,
+                data: r.data,
+                bytes: r.bytes,
+                url,
+            };
+        }
+        return { ok: true, status: r.status, contentType: r.contentType, body: r.content, truncated: r.truncated };
+    },
+    toModelOutput: webFetchToModelOutput,
+});
+// ── askUser ─────────────────────────────────────────────────────────────────
+/**
+ * Ask the user one or more multiple-choice questions and wait for their answer.
+ * Has NO `execute`: the SDK leaves the call in `input-available`, the turn
+ * pauses, and the client renders a questionnaire and supplies the result via
+ * `addToolResult` (output = a JSON object mapping each question → the picked
+ * answer), which resumes the run.
+ */
+const askUser = tool({
+    description: "Ask the user one or more multiple-choice questions when you need a " +
+        "decision or clarification before continuing. The conversation pauses " +
+        "until the user answers. Prefer this over guessing.",
+    inputSchema: jsonSchema({
+        type: "object",
+        properties: {
+            questions: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        question: { type: "string" },
+                        header: { type: "string" },
+                        multiSelect: { type: "boolean" },
+                        options: {
+                            type: "array",
+                            items: {
+                                type: "object",
+                                properties: { label: { type: "string" }, description: { type: "string" } },
+                                required: ["label", "description"],
+                                additionalProperties: false,
+                            },
+                        },
+                    },
+                    required: ["question", "options"],
+                    additionalProperties: false,
+                },
+            },
+        },
+        required: ["questions"],
+        additionalProperties: false,
+    }),
+    // No `execute` — client-handled. The answer comes back via addToolResult.
+});
+// ── Schedules (read + cancel; creation is host policy) ──────────────────────
+// Everything a tool needs is on `options.context`: the principal AND the
+// runtime the turn runs in — no host-global required. Creating a schedule
+// stays with the host (it decides delivery targets, rate floors, approval).
+const list_schedules = tool({
+    description: "List the user's scheduled runs (all agents), with ids for cancel_schedule.",
+    inputSchema: jsonSchema({ type: "object", properties: {}, additionalProperties: false }),
+    execute: async (_args, options) => {
+        const { principal, runtime } = harnessContextOf(options);
+        if (!principal || !runtime)
+            return { error: "No principal/runtime for this turn." };
+        const schedules = await runtime.listSchedules({ principal });
+        return {
+            schedules: schedules.map((s) => ({
+                id: s.id,
+                agent: s.agent,
+                cron: s.cron ?? "one-off",
+                timezone: s.timezone ?? "UTC",
+                prompt: s.prompt,
+                enabled: s.enabled,
+                nextRunAt: new Date(s.nextRunAt).toISOString(),
+            })),
+        };
+    },
+});
+const cancel_schedule = tool({
+    description: "Cancel one of the user's scheduled runs by id (from list_schedules). Use this " +
+        "when they say to stop a recurring run.",
+    inputSchema: jsonSchema({
+        type: "object",
+        properties: { id: { type: "string", description: "Schedule id from list_schedules." } },
+        required: ["id"],
+        additionalProperties: false,
+    }),
+    execute: async (args, options) => {
+        const { principal, runtime } = harnessContextOf(options);
+        if (!principal || !runtime)
+            return { error: "No principal/runtime for this turn." };
+        // `unschedule` is owner-fenced and returns void, so a stale or foreign id
+        // deletes nothing silently. Confirm it exists first — otherwise the model
+        // tells the user a schedule was cancelled when it wasn't.
+        const mine = await runtime.listSchedules({ principal });
+        if (!mine.some((s) => s.id === args.id)) {
+            return { error: `No schedule ${args.id} — call list_schedules for current ids.` };
+        }
+        await runtime.unschedule({ principal, id: args.id });
+        return { cancelled: args.id };
+    },
+});
+/** Sandbox-backed tools (need an agent with `sandbox: true`). */
+export const sandboxTools = { bash, read_file, write_file, glob, grep };
+/** App-process default tools (granted by `defaultTools`; no sandbox needed). */
+export const appTools = { web_fetch, askUser, list_schedules, cancel_schedule };
+/**
+ * The `RuntimeConfig.harnessTools` bundle: sandbox + app tools, no default
+ * approval gates (nothing here persists a side effect the user hasn't asked
+ * for in the turn). Spread a host's own additions over `app` / `approval`.
+ */
+export function defaultHarnessTools() {
+    return { sandbox: { ...sandboxTools }, app: { ...appTools }, approval: {} };
+}
+//# sourceMappingURL=tools.js.map

package/dist/harness/tools.js.map

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

package/dist/harness/web-fetch.d.ts

@@ -0,0 +1,47 @@
+export type WebFetchFormat = "markdown" | "text" | "html";
+export type WebFetchResult = {
+    ok: true;
+    kind: "text";
+    status: number;
+    contentType: string;
+    content: string;
+    truncated: boolean;
+} | {
+    ok: true;
+    kind: "media";
+    status: number;
+    contentType: string;
+    /** The normalized type the model-facing file part will carry. */
+    mediaType: SupportedMediaType;
+    /** Base64-encoded bytes. */
+    data: string;
+    /** Original (pre-base64) size. */
+    bytes: number;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Media the fetch returns as bytes for the model to SEE rather than as decoded
+ * text: the image types every provider's vision input accepts, plus PDF
+ * (Anthropic renders it as a document block; providers without tool-result PDF
+ * support drop the part but keep the accompanying text).
+ */
+export type SupportedMediaType = "image/png" | "image/jpeg" | "image/gif" | "image/webp" | "application/pdf";
+/**
+ * What media the body is, if it's a type worth showing the model. The
+ * Content-Type header decides when it's one of ours; magic bytes rescue the
+ * common case of a server that lies (application/octet-stream, text/plain) —
+ * sniffing is deliberately limited to unambiguous signatures.
+ */
+export declare function detectMedia(contentType: string, bytes: Uint8Array): SupportedMediaType | null;
+/** HTML → Markdown (Turndown), dropping script/style/meta/link noise. */
+export declare function convertHtmlToMarkdown(html: string): string;
+/** Strip HTML to readable text (no Turndown) — for `format: "text"`. */
+export declare function extractTextFromHtml(html: string): string;
+export declare function webFetch(args: {
+    url: string;
+    format?: WebFetchFormat;
+    timeout?: number;
+}): Promise<WebFetchResult>;
+//# sourceMappingURL=web-fetch.d.ts.map

package/dist/harness/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../src/harness/web-fetch.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1D,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GACpG;IACE,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,SAAS,EAAE,kBAAkB,CAAC;IAC9B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,iBAAiB,CAAC;AAQtB;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,kBAAkB,GAAG,IAAI,CA0B7F;AA2BD,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU1D;AAaD,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAexD;AAkBD,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,cAAc,CAAC,CAqH1B"}