@osovv/vv-opencode 1.5.0 → 1.7.0

package/dist/plugins/web-tools/schemas.js

@@ -0,0 +1,523 @@
+// FILE: src/plugins/web-tools/schemas.ts
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Single source of the two vvoc-owned web tool contracts: registered raw argument maps, strict runtime schemas with explicit execute-time defaults, args-only URL/shape validation, model-facing descriptions, operation examples, concrete search/fetch result metadata/attachment producer schemas, and the owned contracts consumed by the definition and pre-execute publication seam.
+//   SCOPE: Pure contract declarations and args-only validation for web_search and web_fetch: unknown-key rejection, provided-value typing/enum/bounds checks, representable URL scheme/shape checks, and closed result-envelope schemas for the actual provider delivery variants. No network I/O, permission request, credential resolution, provider selection, dispatch, or content rewriting; the services keep transport and credential redaction authority.
+//   DEPENDS: [@opencode-ai/plugin, zod (types), src/lib/agent-tool-contract.ts]
+//   LINKS: [M-PLUGIN-WEB-TOOLS, M-WEB-SEARCH-SERVICE, M-WEB-FETCH-SERVICE, M-AGENT-TOOL-CONTRACT]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   WEB_SEARCH_TOOL_ID - Registered tool id for provider-neutral web search.
+//   WEB_FETCH_TOOL_ID - Registered tool id for provider-neutral web fetch.
+//   WEB_SEARCH_PROVIDERS - Canonical search provider vocabulary.
+//   WEB_FETCH_PROVIDERS - Canonical fetch provider vocabulary.
+//   WEB_CREDENTIAL_SOURCES - Credential provenance vocabulary reported in metadata.
+//   WEB_REGIONS - Canonical Z.AI region vocabulary.
+//   WebRegion - Union of supported Z.AI region identifiers.
+//   SEARCH_FRESHNESS_WINDOWS - Canonical freshness window vocabulary.
+//   WebSearchFreshness - Union of supported freshness window identifiers.
+//   FETCH_FORMATS - Canonical textual output format vocabulary.
+//   WebFetchFormat - Union of supported textual output format identifiers.
+//   WEB_SEARCH_DEFAULT_COUNT - Default result count.
+//   WEB_SEARCH_MIN_COUNT - Minimum result count.
+//   WEB_SEARCH_MAX_COUNT - Maximum result count.
+//   WEB_FETCH_DEFAULT_TIMEOUT_SECONDS - Default per-call timeout in seconds.
+//   WEB_FETCH_MAX_TIMEOUT_SECONDS - Maximum model-configurable timeout in seconds.
+//   webSearchArgs - Registered raw argument map for web_search.
+//   webFetchArgs - Registered raw argument map for web_fetch.
+//   WebSearchToolArgs - Schema-derived web_search argument shape with defaults applied.
+//   WebFetchToolArgs - Schema-derived web_fetch argument shape with defaults applied.
+//   webSearchContract - Owned contract for web_search.
+//   webFetchContract - Owned contract for web_fetch.
+//   webToolContracts - Owned contracts for both web tools (definition adapter input).
+//   WebSearchValidation - Successful parsed search args or bounded issues.
+//   WebFetchValidation - Successful parsed fetch args or bounded issues.
+//   validateWebSearchToolInput - Structural validation for web_search.
+//   validateWebFetchToolInput - Structural plus URL scheme/shape validation for web_fetch.
+//   webSearchMetadataSchema - Closed search metadata schema per provider variant.
+//   webSearchResultSchema - Closed search result envelope producer schema.
+//   webFetchMetadataSchema - Closed fetch metadata schema per provider/delivery variant.
+//   webFetchTextResultSchema - Closed textual fetch result envelope producer schema.
+//   webFetchMediaResultSchema - Closed media/attachment fetch result envelope producer schema.
+//   webFetchResultSchema - Closed fetch result envelope union.
+//   WebSearchResultEnvelope - Schema-derived search result envelope.
+//   WebFetchResultEnvelope - Schema-derived fetch result envelope.
+//   WebSearchMetadata - Schema-derived search metadata union.
+//   WebFetchMetadata - Schema-derived fetch metadata union.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [C-AGENT-TOOL-CONTRACTS T-006 - Initial single-source web input/result contracts with explicit execute-time defaults, URL scheme/shape validation before dispatch, closed provider-variant metadata schemas, and operation examples.]
+// END_CHANGE_SUMMARY
+import { tool } from "@opencode-ai/plugin";
+import { MAX_CONTRACT_ISSUES, MAX_ISSUE_MESSAGE_CHARS, MAX_ISSUE_PATH_CHARS, MAX_ISSUE_VALUE_CHARS, defineOwnedToolContract, ownedToolAttachmentSchema, strictObject, } from "../../lib/agent-tool-contract.js";
+const schema = tool.schema;
+// START_BLOCK_TOOL_IDS
+/** Registered tool id for provider-neutral web search. */
+export const WEB_SEARCH_TOOL_ID = "web_search";
+/** Registered tool id for provider-neutral web fetch. */
+export const WEB_FETCH_TOOL_ID = "web_fetch";
+/** Canonical search provider vocabulary. */
+export const WEB_SEARCH_PROVIDERS = ["exa", "brave", "zai"];
+/** Canonical fetch provider vocabulary. */
+export const WEB_FETCH_PROVIDERS = ["native", "spider", "zai"];
+/** Credential provenance vocabulary reported in result metadata. */
+export const WEB_CREDENTIAL_SOURCES = ["env", "config"];
+/** Canonical Z.AI region vocabulary (matches the canonical vvoc web region enum). */
+export const WEB_REGIONS = ["international", "china"];
+/** Canonical freshness window vocabulary. */
+export const SEARCH_FRESHNESS_WINDOWS = ["day", "week", "month", "year"];
+/** Canonical textual output format vocabulary. */
+export const FETCH_FORMATS = ["markdown", "text", "html"];
+/** Default result count. */
+export const WEB_SEARCH_DEFAULT_COUNT = 8;
+/** Minimum result count. */
+export const WEB_SEARCH_MIN_COUNT = 1;
+/** Maximum result count. */
+export const WEB_SEARCH_MAX_COUNT = 20;
+/** Default per-call timeout in seconds. */
+export const WEB_FETCH_DEFAULT_TIMEOUT_SECONDS = 30;
+/** Maximum model-configurable timeout in seconds. */
+export const WEB_FETCH_MAX_TIMEOUT_SECONDS = 120;
+// END_BLOCK_TOOL_IDS
+// START_BLOCK_ARG_MAPS
+/**
+ * Registered raw argument map for web_search (single source of the tool surface).
+ * Provider-neutral: no credential, provider, or region arguments are accepted.
+ * count carries a representable 1..20 integer bound and the documented default;
+ * the execute boundary re-applies the default because the host forwards raw args.
+ */
+export const webSearchArgs = {
+    query: schema.string().min(1).describe("The search query; the text is sent unchanged."),
+    count: schema
+        .number()
+        .int()
+        .min(WEB_SEARCH_MIN_COUNT)
+        .max(WEB_SEARCH_MAX_COUNT)
+        .default(WEB_SEARCH_DEFAULT_COUNT)
+        .describe(`Number of results, integer ${WEB_SEARCH_MIN_COUNT} through ${WEB_SEARCH_MAX_COUNT}, default ${WEB_SEARCH_DEFAULT_COUNT}.`),
+    freshness: schema
+        .enum(SEARCH_FRESHNESS_WINDOWS)
+        .optional()
+        .describe("Optional time window restricting results: day, week, month, or year."),
+};
+const webSearchArgsObject = strictObject(webSearchArgs);
+/**
+ * Registered raw argument map for web_fetch (single source of the tool surface).
+ * Provider-neutral: no credential or provider arguments are accepted.
+ * format and timeout carry the documented defaults; the execute boundary re-applies
+ * them because the host forwards raw args. A provider may drop the numeric bound
+ * during schema lowering, so the positive/maximum rule stays runtime-enforced.
+ */
+export const webFetchArgs = {
+    url: schema
+        .string()
+        .min(1)
+        .describe("The HTTP or HTTPS URL to retrieve; the URL is requested unchanged."),
+    format: schema
+        .enum(FETCH_FORMATS)
+        .default("markdown")
+        .describe("Output format for textual resources: markdown, text, or html. Default markdown."),
+    timeout: schema
+        .number()
+        .positive()
+        .max(WEB_FETCH_MAX_TIMEOUT_SECONDS)
+        .default(WEB_FETCH_DEFAULT_TIMEOUT_SECONDS)
+        .describe(`Timeout in seconds: greater than 0 and at most ${WEB_FETCH_MAX_TIMEOUT_SECONDS}; fractional values are allowed. Default ${WEB_FETCH_DEFAULT_TIMEOUT_SECONDS}.`),
+};
+const webFetchArgsObject = strictObject(webFetchArgs);
+// END_BLOCK_ARG_MAPS
+// START_BLOCK_OPERATION_EXAMPLES
+const webSearchExamples = [
+    {
+        operation: "search",
+        label: "query only applies count 8",
+        expect: "accept",
+        input: { query: "vvoc" },
+    },
+    {
+        operation: "search",
+        label: "explicit integer count at the maximum",
+        expect: "accept",
+        input: { query: "vvoc", count: WEB_SEARCH_MAX_COUNT },
+    },
+    {
+        operation: "search",
+        label: "freshness window filters results",
+        expect: "accept",
+        input: { query: "vvoc", freshness: "week" },
+    },
+    {
+        operation: "search",
+        label: "count below the minimum",
+        expect: "reject",
+        input: { query: "vvoc", count: 0 },
+    },
+    {
+        operation: "search",
+        label: "count above the maximum",
+        expect: "reject",
+        input: { query: "vvoc", count: WEB_SEARCH_MAX_COUNT + 1 },
+    },
+    {
+        operation: "search",
+        label: "fractional count is not an integer",
+        expect: "reject",
+        input: { query: "vvoc", count: 1.5 },
+    },
+    {
+        operation: "search",
+        label: "string count is not coerced",
+        expect: "reject",
+        input: { query: "vvoc", count: "8" },
+    },
+    {
+        operation: "search",
+        label: "null count is not a default",
+        expect: "reject",
+        input: { query: "vvoc", count: null },
+    },
+    {
+        operation: "search",
+        label: "unknown freshness window",
+        expect: "reject",
+        input: { query: "vvoc", freshness: "hour" },
+    },
+    {
+        operation: "search",
+        label: "credential or provider selection is not a caller argument",
+        expect: "reject",
+        input: { query: "vvoc", credential: "secret", provider: "brave" },
+    },
+];
+const webFetchExamples = [
+    {
+        operation: "fetch",
+        label: "url only applies markdown and 30 seconds",
+        expect: "accept",
+        input: { url: "https://example.test/page" },
+    },
+    {
+        operation: "fetch",
+        label: "text format with a fractional positive timeout",
+        expect: "accept",
+        input: { url: "https://example.test/page", format: "text", timeout: 0.5 },
+    },
+    {
+        operation: "fetch",
+        label: "html format at the timeout maximum",
+        expect: "accept",
+        input: {
+            url: "https://example.test/page",
+            format: "html",
+            timeout: WEB_FETCH_MAX_TIMEOUT_SECONDS,
+        },
+    },
+    {
+        operation: "fetch",
+        label: "relative url has no absolute scheme",
+        expect: "reject",
+        input: { url: "/page" },
+    },
+    {
+        operation: "fetch",
+        label: "file scheme is unsupported",
+        expect: "reject",
+        input: { url: "file:///tmp/secret" },
+    },
+    {
+        operation: "fetch",
+        label: "data scheme is unsupported",
+        expect: "reject",
+        input: { url: "data:text/plain,hello" },
+    },
+    {
+        operation: "fetch",
+        label: "ftp scheme is unsupported",
+        expect: "reject",
+        input: { url: "ftp://example.test/file" },
+    },
+    {
+        operation: "fetch",
+        label: "malformed host is unparseable",
+        expect: "reject",
+        input: { url: "https://exa mple.test" },
+    },
+    {
+        operation: "fetch",
+        label: "unsupported format",
+        expect: "reject",
+        input: { url: "https://example.test/page", format: "pdf" },
+    },
+    {
+        operation: "fetch",
+        label: "timeout of zero is not positive",
+        expect: "reject",
+        input: { url: "https://example.test/page", timeout: 0 },
+    },
+    {
+        operation: "fetch",
+        label: "timeout above the maximum",
+        expect: "reject",
+        input: { url: "https://example.test/page", timeout: WEB_FETCH_MAX_TIMEOUT_SECONDS + 1 },
+    },
+    {
+        operation: "fetch",
+        label: "string timeout is not coerced",
+        expect: "reject",
+        input: { url: "https://example.test/page", timeout: "30" },
+    },
+    {
+        operation: "fetch",
+        label: "null timeout is not a default",
+        expect: "reject",
+        input: { url: "https://example.test/page", timeout: null },
+    },
+    {
+        operation: "fetch",
+        label: "credential or provider selection is not a caller argument",
+        expect: "reject",
+        input: { url: "https://example.test/page", apiKey: "secret", provider: "spider" },
+    },
+];
+// END_BLOCK_OPERATION_EXAMPLES
+// START_BLOCK_CONTRACTS
+/** Owned contract for web_search. */
+export const webSearchContract = defineOwnedToolContract({
+    toolId: WEB_SEARCH_TOOL_ID,
+    description: "Search the web using the configured provider and return ranked results as Markdown. Use for discovering information; returns titles, URLs, snippets, and dates.",
+    registeredArgs: webSearchArgs,
+    examples: webSearchExamples,
+});
+/** Owned contract for web_fetch. */
+export const webFetchContract = defineOwnedToolContract({
+    toolId: WEB_FETCH_TOOL_ID,
+    description: "Fetch a known HTTP or HTTPS URL using the configured provider. Returns Markdown, text, raw HTML, or an image/PDF attachment.",
+    registeredArgs: webFetchArgs,
+    examples: webFetchExamples,
+});
+/** Owned contracts for both web tools (input to the owned definition/pre-execute adapters). */
+export const webToolContracts = [
+    webSearchContract,
+    webFetchContract,
+];
+// END_BLOCK_CONTRACTS
+// START_BLOCK_ISSUE_HELPERS
+function truncateChars(value, max) {
+    if (value.length <= max)
+        return value;
+    return `${value.slice(0, Math.max(0, max - 1))}…`;
+}
+function boundedIssue(issue) {
+    return {
+        code: issue.code,
+        path: truncateChars(issue.path, MAX_ISSUE_PATH_CHARS),
+        message: truncateChars(issue.message, MAX_ISSUE_MESSAGE_CHARS),
+        ...(issue.expected !== undefined
+            ? { expected: truncateChars(issue.expected, MAX_ISSUE_MESSAGE_CHARS) }
+            : {}),
+        ...(issue.received !== undefined
+            ? { received: truncateChars(issue.received, MAX_ISSUE_VALUE_CHARS) }
+            : {}),
+    };
+}
+function pushIssue(issues, issue) {
+    if (issues.length >= MAX_CONTRACT_ISSUES)
+        return;
+    issues.push(boundedIssue(issue));
+}
+/**
+ * Strict structural validation for web_search.
+ * Unknown root keys, malformed provided values, unsupported freshness windows, and
+ * out-of-bounds counts reject; the documented count default is applied for execute.
+ * The query text is preserved verbatim.
+ */
+export function validateWebSearchToolInput(raw) {
+    const parsed = webSearchContract.safeParse(raw);
+    if (!parsed.success) {
+        return { ok: false, issues: parsed.issues };
+    }
+    return { ok: true, data: parsed.data };
+}
+/**
+ * Strict structural plus URL scheme/shape validation for web_fetch.
+ * Structural failures reject first; then the URL must parse as an absolute HTTP or
+ * HTTPS URL. Diagnostics identify the offending `url` field with a bounded message
+ * that never echoes the raw URL (which may carry credentials) or an error payload.
+ * The format and timeout defaults are applied for execute.
+ */
+export function validateWebFetchToolInput(raw) {
+    const parsed = webFetchContract.safeParse(raw);
+    if (!parsed.success) {
+        return { ok: false, issues: parsed.issues };
+    }
+    const issues = [];
+    let parsedUrl;
+    try {
+        parsedUrl = new URL(parsed.data.url);
+    }
+    catch {
+        pushIssue(issues, {
+            code: "invalid_format",
+            path: "url",
+            message: "url must be an absolute HTTP or HTTPS URL",
+            expected: "an absolute http(s) URL",
+        });
+    }
+    if (parsedUrl && parsedUrl.protocol !== "http:" && parsedUrl.protocol !== "https:") {
+        const scheme = truncateChars(parsedUrl.protocol.replace(/:$/, ""), MAX_ISSUE_VALUE_CHARS);
+        pushIssue(issues, {
+            code: "invalid_value",
+            path: "url",
+            message: `unsupported URL scheme "${scheme}"; only http and https are supported`,
+            expected: "http or https",
+        });
+    }
+    if (issues.length > 0) {
+        return { ok: false, issues };
+    }
+    return { ok: true, data: parsed.data };
+}
+// END_BLOCK_VALIDATION
+// START_BLOCK_RESULT_SCHEMAS
+const credentialSourceSchema = schema.enum(WEB_CREDENTIAL_SOURCES);
+const formatSchema = schema.enum(FETCH_FORMATS);
+const regionSchema = schema.enum(WEB_REGIONS);
+const [EXA, BRAVE, ZAI_SEARCH] = WEB_SEARCH_PROVIDERS;
+const [NATIVE, SPIDER, ZAI_FETCH] = WEB_FETCH_PROVIDERS;
+/**
+ * Closed search metadata schemas for the actual delivery variants.
+ * `region` is present only for the direct Z.AI provider; unknown fields and
+ * missing known fields reject.
+ */
+export const webSearchMetadataSchema = schema.union([
+    strictObject({
+        provider: schema.literal(EXA),
+        resultCount: schema.number().int().min(0),
+        credentialSource: credentialSourceSchema,
+    }),
+    strictObject({
+        provider: schema.literal(BRAVE),
+        resultCount: schema.number().int().min(0),
+        credentialSource: credentialSourceSchema,
+    }),
+    strictObject({
+        provider: schema.literal(ZAI_SEARCH),
+        region: regionSchema,
+        resultCount: schema.number().int().min(0),
+        credentialSource: credentialSourceSchema,
+    }),
+]);
+/**
+ * Closed result envelope for web_search producer/test checks.
+ * `output` is the rendered Markdown document and stays a declared opaque string.
+ * This is never applied as a throw-after-side-effect execute wrapper.
+ */
+export const webSearchResultSchema = strictObject({
+    title: schema.string(),
+    output: schema.string(),
+    metadata: webSearchMetadataSchema,
+});
+/**
+ * Closed fetch metadata schemas for the actual provider/delivery variants.
+ * Native reports its status; Spider may add status/duration; Z.AI reader text
+ * carries its regional request metadata while direct Z.AI media reports only the
+ * region/format/credential provenance. Region is required for every Z.AI variant.
+ */
+export const webFetchMetadataSchema = schema.union([
+    strictObject({
+        provider: schema.literal(NATIVE),
+        format: formatSchema,
+        status: schema.number().int(),
+    }),
+    strictObject({
+        provider: schema.literal(SPIDER),
+        format: formatSchema,
+        credentialSource: credentialSourceSchema,
+        status: schema.number().int().optional(),
+        durationMs: schema.number().optional(),
+    }),
+    strictObject({
+        provider: schema.literal(ZAI_FETCH),
+        region: regionSchema,
+        format: formatSchema,
+        credentialSource: credentialSourceSchema,
+        status: schema.number().int(),
+        requestId: schema.string().optional(),
+        model: schema.string().optional(),
+        created: schema.number().optional(),
+        title: schema.string().optional(),
+    }),
+    strictObject({
+        provider: schema.literal(ZAI_FETCH),
+        region: regionSchema,
+        format: formatSchema,
+        credentialSource: credentialSourceSchema,
+    }),
+]);
+/** Closed textual fetch result envelope producer schema (no attachments region). */
+export const webFetchTextResultSchema = strictObject({
+    title: schema.string(),
+    output: schema.string(),
+    metadata: schema.union([
+        strictObject({
+            provider: schema.literal(NATIVE),
+            format: formatSchema,
+            status: schema.number().int(),
+        }),
+        strictObject({
+            provider: schema.literal(SPIDER),
+            format: formatSchema,
+            credentialSource: credentialSourceSchema,
+            status: schema.number().int().optional(),
+            durationMs: schema.number().optional(),
+        }),
+        strictObject({
+            provider: schema.literal(ZAI_FETCH),
+            region: regionSchema,
+            format: formatSchema,
+            credentialSource: credentialSourceSchema,
+            status: schema.number().int(),
+            requestId: schema.string().optional(),
+            model: schema.string().optional(),
+            created: schema.number().optional(),
+            title: schema.string().optional(),
+        }),
+    ]),
+});
+/** Closed media fetch result envelope producer schema requiring a real attachment. */
+export const webFetchMediaResultSchema = strictObject({
+    title: schema.string(),
+    output: schema.string(),
+    metadata: schema.union([
+        strictObject({
+            provider: schema.literal(NATIVE),
+            format: formatSchema,
+            status: schema.number().int(),
+        }),
+        strictObject({
+            provider: schema.literal(SPIDER),
+            format: formatSchema,
+            credentialSource: credentialSourceSchema,
+            status: schema.number().int().optional(),
+            durationMs: schema.number().optional(),
+        }),
+        strictObject({
+            provider: schema.literal(ZAI_FETCH),
+            region: regionSchema,
+            format: formatSchema,
+            credentialSource: credentialSourceSchema,
+        }),
+    ]),
+    attachments: schema.array(ownedToolAttachmentSchema).min(1),
+});
+/** Closed fetch result envelope union for producer/test checks. */
+export const webFetchResultSchema = schema.union([
+    webFetchTextResultSchema,
+    webFetchMediaResultSchema,
+]);
+// END_BLOCK_RESULT_SCHEMAS
+//# sourceMappingURL=schemas.js.map

package/dist/plugins/web-tools/schemas.js.map

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

package/dist/plugins/web-tools/search-service.d.ts

@@ -9,9 +9,12 @@ import { type WebSearchResult } from "./providers/exa.js";
 export declare function renderSearchMarkdown(results: WebSearchResult[]): string;
 /**
  * Create the web_search tool bound to the resolved search configuration.
- * execute asks permission key web_search with patterns [query], validates the credential
- * at execution time, dispatches to exa, brave, or direct zai, and returns a ToolResult with
- * title, Markdown output, and metadata { provider, region?, resultCount, credentialSource }.
+ * execute validates raw host-forwarded arguments through the shared strict contract first,
+ * so unknown keys, invalid provided values, and out-of-range counts reject with a bounded
+ * diagnostic before any permission request, credential lookup, or provider dispatch.
+ * The documented count default is re-applied here because the host forwards unparsed raw
+ * arguments. Permission uses key web_search with patterns [query], and the result reports
+ * metadata { provider, region?, resultCount, credentialSource }.
  * Missing credentials raise an actionable error naming the environment variable
  * and the web.search.apiKey config field without printing any value.
  */