@once-agent/sdk 0.1.11 → 0.1.12

package/README.md

@@ -1,10 +1,86 @@
 # @once-agent/sdk
 
+> **Automatic Connect in 0.1.12:** this SDK version includes the
+> `@once-agent/sdk/connect` public surface for automatic tool classification,
+> whole-toolset wiring, trusted intent identity, conservative effect binding,
+> and OpenAI Agents FunctionTool wrapping. It has passed source, packed-package,
+> ESM/CommonJS, and Node.js 24.15 protected-execution gates.
+>
+> Full guide: https://github.com/stringsofthemind-oss/once/blob/main/docs/CONNECT_AUTO.md
+
 > **Local protection:** `protectLocal` wraps an existing async function using a
 > durable same-machine SQLite file. This feature requires Node.js 24.15 or
 > later. See the local function guide:
 > https://github.com/stringsofthemind-oss/once/blob/main/examples/local-function/README.md
 
+## Automatic Connect
+
+Automatic Connect is designed for the integration path where an application
+already has a registry or framework list of agent tools.
+
+```ts
+import {
+  connectLocalAgentToolsetAuto
+} from "@once-agent/sdk/connect";
+
+const connected = connectLocalAgentToolsetAuto(
+  {
+    search_web: {
+      async execute(input: { query: string }) {
+        return search(input.query);
+      }
+    },
+    send_email: {
+      async execute(input: {
+        intentId: string;
+        destination: string;
+        body: string;
+      }) {
+        return mailer.send({
+          to: input.destination,
+          body: input.body
+        });
+      }
+    }
+  },
+  {
+    manifest: [
+      {
+        name: "search_web",
+        description: "Search the public web."
+      },
+      {
+        name: "send_email",
+        description: "Send an email to a recipient.",
+        _meta: {
+          once: {
+            identityFields: ["intentId"],
+            effectFields: ["destination", "body"]
+          }
+        }
+      }
+    ],
+    statePath: ".once/agent-tools.sqlite"
+  }
+);
+
+// Give the agent only the connected tools.
+const toolsForAgent = connected.tools;
+```
+
+Automatic Connect classifies tools as `BYPASS`, `PROTECT`, or `UNKNOWN`.
+`UNKNOWN` fails closed. Whole-toolset connection is all-or-nothing: duplicate,
+missing, undeclared, invalid, or unresolved tools block connection rather than
+silently exposing a partially protected registry.
+
+Protected automatic local execution still requires a trustworthy logical action
+identity and a payload that represents the consequential effect. Explicit
+`identityFields` and `effectFields` are preferred when available. Framework or
+transport attempt IDs are not automatically treated as business intent.
+
+The automatic local path requires Node.js 24.15+ and shared durable SQLite state
+on one machine. It is not a universal exactly-once or multi-host guarantee.
+
 
 <!-- ONCE_STRIPE_SANDBOX_NOTICE -->
 
@@ -533,4 +609,3 @@ That is the failure mode Once is built to address.
 ## License
 
 MIT
-

package/dist/cli.js

@@ -6,16 +6,26 @@ import { runProtect } from "./protect.js";
 import { applyProtectionPlan } from "./apply.js";
 import { runBenchmark } from "./benchmark.js";
 import { runTraceFetch } from "./trace.js";
+import { discoverToolGraph } from "./tool-discovery.js";
+import { printToolDiscoveryReport } from "./tool-report.js";
+import { discoverLiveMcpTools } from "./mcp-live-discovery.js";
+import { printMcpLiveDiscoveryReport } from "./mcp-live-report.js";
+import { watchMcpToolListOnce } from "./mcp-tool-refresh.js";
+import { printMcpToolRefreshReport } from "./mcp-tool-refresh-report.js";
 function printHelp() {
     console.log("");
     console.log("Once");
     console.log("----");
     console.log("");
     console.log("Commands:");
-    console.log("  once doctor [directory] [--protect] [--connection]");
+    console.log("  once doctor [directory] [--protect] [--connection] [--tools] [--tools-live=<host/name>] [--tools-watch-ms=<ms>]");
     console.log("      Run the low-friction local safety check. No API key required.");
     console.log("      Use --protect to generate a review plan and snippets without changing source.");
     console.log("      Use --connection to also verify the hosted Once API connection.");
+    console.log("      Use --tools to inventory local/configured tool surfaces and rank source-discovered capabilities.");
+    console.log("      Use --tools-live=<host/name> with --tools to explicitly enumerate one configured remote HTTP MCP server. Repeat to select more than one.");
+    console.log("      Use --tools-watch-ms=<50..60000> with exactly one --tools-live target to wait for one modern MCP tool-list change, refresh tools/list, report the diff, then exit.");
+    console.log("      Live tool enumeration/watch never launches configured stdio servers and does not follow redirects.");
     console.log("");
     console.log("  once protect [directory]");
     console.log("      Review candidate operations for Once protection.");
@@ -40,6 +50,9 @@ function printHelp() {
     console.log("");
     console.log("Examples:");
     console.log("  once doctor .");
+    console.log("  once doctor . --tools");
+    console.log("  once doctor . --tools --tools-live=cursor/docs");
+    console.log("  once doctor . --tools --tools-live=cursor/docs --tools-watch-ms=5000");
     console.log("  once doctor . --protect");
     console.log("  once doctor . --connection");
     console.log("  once protect .");
@@ -58,10 +71,46 @@ async function main() {
     switch (command) {
         case "doctor": {
             const requestedPath = args.find(value => !value.startsWith("--")) ?? ".";
+            const liveSelectors = args
+                .filter(value => value.startsWith("--tools-live="))
+                .map(value => value.substring("--tools-live=".length).trim())
+                .filter(Boolean);
+            const watchArgument = args.find(value => value.startsWith("--tools-watch-ms="));
+            const watchMs = watchArgument
+                ? Number(watchArgument.substring("--tools-watch-ms=".length))
+                : undefined;
+            if (args.includes("--tools-live")) {
+                throw new Error("--tools-live requires an explicit configured server selector. Example: --tools-live=cursor/docs");
+            }
+            if (args.includes("--tools-watch-ms")) {
+                throw new Error("--tools-watch-ms requires a bounded millisecond value. Example: --tools-watch-ms=5000");
+            }
+            if (liveSelectors.length > 0 &&
+                !args.includes("--tools")) {
+                throw new Error("--tools-live must be used with --tools so the configured server inventory is reviewed before live enumeration.");
+            }
+            if (watchArgument && liveSelectors.length !== 1) {
+                throw new Error("--tools-watch-ms requires exactly one --tools-live=<host/name> target.");
+            }
+            if (watchArgument && !Number.isFinite(watchMs)) {
+                throw new Error("--tools-watch-ms must be a finite millisecond value.");
+            }
             await runDoctor(requestedPath, {
                 protect: args.includes("--protect"),
                 connection: args.includes("--connection")
             });
+            if (args.includes("--tools")) {
+                const discovery = await discoverToolGraph(requestedPath);
+                printToolDiscoveryReport(discovery);
+                if (liveSelectors.length > 0) {
+                    const live = await discoverLiveMcpTools(requestedPath, discovery.configuredSources, liveSelectors);
+                    printMcpLiveDiscoveryReport(live);
+                    if (watchArgument && watchMs !== undefined) {
+                        const refresh = await watchMcpToolListOnce(requestedPath, discovery.configuredSources, liveSelectors[0], live, { watchMs });
+                        printMcpToolRefreshReport(refresh);
+                    }
+                }
+            }
             return;
         }
         case "trace": {

package/dist/cli.js.map

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

package/dist/connect/identity.d.ts

@@ -0,0 +1,22 @@
+import type { ConnectToolDescriptor } from "./tool-classifier.js";
+export type ConnectIdentitySource = "explicit" | "input:once_operation_id" | "input:onceOperationId" | "input:operation_id" | "input:operationId" | "input:idempotency_key" | "input:idempotencyKey" | "input:intent_id" | "input:intentId" | "input:intent_key" | "input:intentKey" | "meta:identity_fields";
+export type ConnectIdentityResult = Readonly<{
+    status: "FOUND";
+    operationId: string;
+    source: ConnectIdentitySource;
+    reason: string;
+}> | Readonly<{
+    status: "REQUIRED";
+    reason: string;
+}> | Readonly<{
+    status: "CONFLICT";
+    sources: readonly ConnectIdentitySource[];
+    reason: string;
+}>;
+export interface ResolveConnectIdentityInput {
+    tool: Pick<ConnectToolDescriptor, "name" | "_meta">;
+    input: unknown;
+    explicitIdentity?: string;
+}
+export declare function resolveConnectToolOperationIdentity(request: ResolveConnectIdentityInput): ConnectIdentityResult;
+//# sourceMappingURL=identity.d.ts.map

package/dist/connect/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/connect/identity.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,qBAAqB,GAC7B,UAAU,GACV,yBAAyB,GACzB,uBAAuB,GACvB,oBAAoB,GACpB,mBAAmB,GACnB,uBAAuB,GACvB,sBAAsB,GACtB,iBAAiB,GACjB,gBAAgB,GAChB,kBAAkB,GAClB,iBAAiB,GACjB,sBAAsB,CAAC;AAE3B,MAAM,MAAM,qBAAqB,GAC7B,QAAQ,CAAC;IACP,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,GACF,QAAQ,CAAC;IACP,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,GACF,QAAQ,CAAC;IACP,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEP,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAsID,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,2BAA2B,GACnC,qBAAqB,CA+EvB"}

package/dist/connect/identity.js

@@ -0,0 +1,159 @@
+import { createHash } from "node:crypto";
+import { canonicalizeConnectPayload, } from "./binding.js";
+const INPUT_FIELDS = [
+    { key: "once_operation_id", source: "input:once_operation_id" },
+    { key: "onceOperationId", source: "input:onceOperationId" },
+    { key: "operation_id", source: "input:operation_id" },
+    { key: "operationId", source: "input:operationId" },
+    { key: "idempotency_key", source: "input:idempotency_key" },
+    { key: "idempotencyKey", source: "input:idempotencyKey" },
+    { key: "intent_id", source: "input:intent_id" },
+    { key: "intentId", source: "input:intentId" },
+    { key: "intent_key", source: "input:intent_key" },
+    { key: "intentKey", source: "input:intentKey" },
+];
+function cleanString(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const cleaned = value.trim();
+    return cleaned.length > 0 ? cleaned : null;
+}
+function plainObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    const objectValue = value;
+    const prototype = Object.getPrototypeOf(objectValue);
+    if (prototype !== Object.prototype && prototype !== null) {
+        return null;
+    }
+    return objectValue;
+}
+function metadataIdentityFields(tool) {
+    const meta = plainObject(tool._meta);
+    if (!meta) {
+        return null;
+    }
+    const once = plainObject(meta.once);
+    if (!once || !Array.isArray(once.identityFields)) {
+        return null;
+    }
+    const fields = once.identityFields;
+    if (fields.length === 0 ||
+        fields.some(field => typeof field !== "string" ||
+            field.trim().length === 0 ||
+            field.includes("."))) {
+        return null;
+    }
+    return Object.freeze(fields.map(field => field.trim()));
+}
+function metadataIdentityCandidate(tool, input) {
+    const fields = metadataIdentityFields(tool);
+    if (!fields) {
+        return null;
+    }
+    const identity = {};
+    for (const field of fields) {
+        if (!(field in input)) {
+            return null;
+        }
+        const value = input[field];
+        if (value === undefined) {
+            return null;
+        }
+        identity[field] = value;
+    }
+    try {
+        return {
+            source: "meta:identity_fields",
+            value: canonicalizeConnectPayload(identity),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function buildOperationId(toolName, identity) {
+    const hash = createHash("sha256");
+    hash.update("once-connect-id-v1\u0000", "utf8");
+    for (const value of [toolName, identity]) {
+        const bytes = Buffer.from(value, "utf8");
+        const length = Buffer.allocUnsafe(4);
+        length.writeUInt32BE(bytes.length, 0);
+        hash.update(length);
+        hash.update(bytes);
+    }
+    const prefix = toolName
+        .toLowerCase()
+        .replace(/[^a-z0-9._:-]+/g, "-")
+        .replace(/^[^a-z0-9]+/, "")
+        .replace(/-+$/g, "")
+        .slice(0, 48) || "tool";
+    return `${prefix}:${hash.digest("hex").slice(0, 32)}`;
+}
+export function resolveConnectToolOperationIdentity(request) {
+    if (!request ||
+        !request.tool ||
+        typeof request.tool.name !== "string" ||
+        request.tool.name.trim().length === 0) {
+        return Object.freeze({
+            status: "REQUIRED",
+            reason: "A stable tool name is required before operation identity can be resolved.",
+        });
+    }
+    const input = plainObject(request.input);
+    if (!input) {
+        return Object.freeze({
+            status: "REQUIRED",
+            reason: "Parsed plain-object tool input is required before operation identity can be resolved.",
+        });
+    }
+    const candidates = [];
+    const explicit = cleanString(request.explicitIdentity);
+    if (explicit) {
+        candidates.push({
+            source: "explicit",
+            value: explicit,
+        });
+    }
+    for (const field of INPUT_FIELDS) {
+        const value = cleanString(input[field.key]);
+        if (value) {
+            candidates.push({
+                source: field.source,
+                value,
+            });
+        }
+    }
+    if (candidates.length > 0) {
+        const values = Array.from(new Set(candidates.map(candidate => candidate.value)));
+        if (values.length !== 1) {
+            return Object.freeze({
+                status: "CONFLICT",
+                sources: Object.freeze(candidates.map(candidate => candidate.source)),
+                reason: "Stable identity carriers disagree. Once Connect refuses ambiguous logical-operation identity.",
+            });
+        }
+        return Object.freeze({
+            status: "FOUND",
+            operationId: buildOperationId(request.tool.name.trim(), values[0]),
+            source: candidates[0].source,
+            reason: "Stable logical-operation identity found and deterministically scoped to this tool.",
+        });
+    }
+    const metadataCandidate = metadataIdentityCandidate(request.tool, input);
+    if (metadataCandidate) {
+        return Object.freeze({
+            status: "FOUND",
+            operationId: buildOperationId(request.tool.name.trim(), metadataCandidate.value),
+            source: metadataCandidate.source,
+            reason: "Tool metadata declared the input fields that define stable logical-operation identity.",
+        });
+    }
+    return Object.freeze({
+        status: "REQUIRED",
+        reason: "No trustworthy stable identity carrier was found. Once Connect refuses to guess from the full payload.",
+    });
+}
+//# sourceMappingURL=identity.js.map

package/dist/connect/identity.js.map

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

package/dist/connect/index.d.ts

@@ -0,0 +1,17 @@
+export { CONNECT_DECISION, classifyConnectOperation, } from "./classifier.js";
+export type { ConnectDecision, ConnectSafetyDeclaration, ConnectClassification, } from "./classifier.js";
+export { CONNECT_TOOL_DECISION, classifyConnectTool, classifyConnectTools, } from "./tool-classifier.js";
+export type { ConnectToolDecision, ConnectToolAnnotations, ConnectToolDescriptor, ConnectToolClassificationReason, ConnectToolClassification, } from "./tool-classifier.js";
+export { CONNECT_MANIFEST_VERSION, planConnectToolManifest, } from "./manifest.js";
+export type { ConnectManifestToolSource, ConnectManifestPlanEntry, ConnectManifestPlanSummary, ConnectManifestPlan, } from "./manifest.js";
+export { resolveConnectToolOperationIdentity, } from "./identity.js";
+export type { ConnectIdentitySource, ConnectIdentityResult, ResolveConnectIdentityInput, } from "./identity.js";
+export { resolveConnectToolEffectPayload, } from "./payload.js";
+export type { ConnectPayloadSource, ConnectEffectPayloadResult, ResolveConnectEffectPayloadInput, } from "./payload.js";
+export { connectLocalAgentToolAuto, AgentToolConnectionError, } from "./local-agent-tool.js";
+export type { AgentTool, AutoLocalAgentToolContract, } from "./local-agent-tool.js";
+export { connectLocalAgentToolsetAuto, } from "./toolset.js";
+export type { LocalAgentToolRegistry, ConnectedLocalAgentToolRegistry, AutoLocalAgentToolsetOverride, AutoLocalAgentToolsetOptions, ConnectedLocalAgentToolset, } from "./toolset.js";
+export { connectOpenAIAgentsFunctionToolsAuto, OpenAIAgentsConnectError, } from "./openai-function-tools.js";
+export type { OpenAIAgentsParsedToolInput, OpenAIAgentsFunctionToolLike, OpenAIAgentsFunctionToolOverride, ConnectOpenAIAgentsFunctionToolsOptions, ConnectedOpenAIAgentsFunctionTools, } from "./openai-function-tools.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/connect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,eAAe,EACf,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mCAAmC,GACpC,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,+BAA+B,GAChC,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,SAAS,EACT,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,sBAAsB,EACtB,+BAA+B,EAC/B,6BAA6B,EAC7B,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oCAAoC,EACpC,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,2BAA2B,EAC3B,4BAA4B,EAC5B,gCAAgC,EAChC,uCAAuC,EACvC,kCAAkC,GACnC,MAAM,4BAA4B,CAAC"}

package/dist/connect/index.js

@@ -0,0 +1,9 @@
+export { CONNECT_DECISION, classifyConnectOperation, } from "./classifier.js";
+export { CONNECT_TOOL_DECISION, classifyConnectTool, classifyConnectTools, } from "./tool-classifier.js";
+export { CONNECT_MANIFEST_VERSION, planConnectToolManifest, } from "./manifest.js";
+export { resolveConnectToolOperationIdentity, } from "./identity.js";
+export { resolveConnectToolEffectPayload, } from "./payload.js";
+export { connectLocalAgentToolAuto, AgentToolConnectionError, } from "./local-agent-tool.js";
+export { connectLocalAgentToolsetAuto, } from "./toolset.js";
+export { connectOpenAIAgentsFunctionToolsAuto, OpenAIAgentsConnectError, } from "./openai-function-tools.js";
+//# sourceMappingURL=index.js.map

package/dist/connect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAQzB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AASvB,OAAO,EACL,mCAAmC,GACpC,MAAM,eAAe,CAAC;AAQvB,OAAO,EACL,+BAA+B,GAChC,MAAM,cAAc,CAAC;AAQtB,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EACL,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AAUtB,OAAO,EACL,oCAAoC,EACpC,wBAAwB,GACzB,MAAM,4BAA4B,CAAC"}

package/dist/connect/local-agent-tool.d.ts

@@ -1,4 +1,5 @@
 import { type ConnectSafetyDeclaration } from "./classifier.js";
+import { type ConnectToolDescriptor } from "./tool-classifier.js";
 import { type LocalObservation } from "../local.js";
 type EffectPayload = Record<string, unknown>;
 export interface AgentTool<Input, Result> {
@@ -21,19 +22,41 @@ export interface LocalAgentToolContract<Input, Result> {
         payload: EffectPayload;
     }) => Promise<LocalObservation<Result>> | LocalObservation<Result>;
 }
+export interface AutoLocalAgentToolContract<Input, Result> {
+    /** Tool metadata used by Once Connect to infer PROTECT/BYPASS/UNKNOWN. */
+    descriptor: ConnectToolDescriptor;
+    /** Optional explicit stable intent identity. When omitted, Once may resolve a trustworthy identity carrier from input. */
+    id?: (input: Input) => string;
+    /** Optional effect selector. When omitted, Once conservatively binds the full plain-object input or descriptor-declared effectFields. */
+    payload?: (input: Input) => EffectPayload;
+    /** Durable same-machine SQLite file, shared by all callers of this tool. */
+    statePath?: string;
+    /** Read-only, authoritative provider lookup for an uncertain outcome. */
+    reconcile?: (context: {
+        id: string;
+        payload: EffectPayload;
+    }) => Promise<LocalObservation<Result>> | LocalObservation<Result>;
+}
 export declare class AgentToolConnectionError extends Error {
     readonly code: string;
     constructor(code: string, message: string);
 }
+export declare function connectLocalAgentTool<Input, Result>(tool: AgentTool<Input, Result>, contract: LocalAgentToolContract<Input, Result>): AgentTool<Input, Result>;
 /**
- * Connect one registered agent tool to Once. The agent calls execute normally;
- * classification happens for every invocation without a model-side Once call.
+ * Connect a local agent tool using its descriptor instead of hand-authored
+ * routing declarations.
+ *
+ * Automatic routing is intentionally conservative:
+ * - PROTECT -> delegate to the existing protected local connector;
+ * - BYPASS -> delegate to the existing bypass path;
+ * - UNKNOWN -> refuse connection until the tool is clarified.
  *
- * The tool owner must review the safety declaration, identity and effect
- * payload. This same-machine path never auto-discovers arbitrary tools and
- * cannot coordinate hosts with separate SQLite files. Supply only the
- * returned tool to the agent; an exposed original tool remains a bypass.
+ * For protected tools, stable identity may be supplied by `id()` or resolved
+ * from trustworthy operation/idempotency/intent carriers. Effect payload may
+ * be supplied by `payload()` or conservatively bound from the full plain-object
+ * input. `_meta.once.effectFields` can explicitly narrow that binding.
+ * Missing/invalid identity or payload fails before the side effect.
  */
-export declare function connectLocalAgentTool<Input, Result>(tool: AgentTool<Input, Result>, contract: LocalAgentToolContract<Input, Result>): AgentTool<Input, Result>;
+export declare function connectLocalAgentToolAuto<Input, Result>(tool: AgentTool<Input, Result>, contract: AutoLocalAgentToolContract<Input, Result>): AgentTool<Input, Result>;
 export {};
 //# sourceMappingURL=local-agent-tool.d.ts.map

package/dist/connect/local-agent-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-agent-tool.d.ts","sourceRoot":"","sources":["../../src/connect/local-agent-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAErB,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7C,MAAM,WAAW,SAAS,CAAC,KAAK,EAAE,MAAM;IACtC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB,CAAC,KAAK,EAAE,MAAM;IACnD,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,MAAM,EAAE,wBAAwB,CAAC;IACjC,8EAA8E;IAC9E,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;IAC9B,gFAAgF;IAChF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,aAAa,CAAC;IAC1C,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE;QACpB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,aAAa,CAAC;KACxB,KAAK,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;CACpE;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAInD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EACjD,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,EAC9B,QAAQ,EAAE,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,GAC9C,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CA8D1B"}
+{"version":3,"file":"local-agent-tool.d.ts","sourceRoot":"","sources":["../../src/connect/local-agent-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAErB,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7C,MAAM,WAAW,SAAS,CAAC,KAAK,EAAE,MAAM;IACtC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB,CAAC,KAAK,EAAE,MAAM;IACnD,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,MAAM,EAAE,wBAAwB,CAAC;IACjC,8EAA8E;IAC9E,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;IAC9B,gFAAgF;IAChF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,aAAa,CAAC;IAC1C,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE;QACpB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,aAAa,CAAC;KACxB,KAAK,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,0BAA0B,CAAC,KAAK,EAAE,MAAM;IACvD,0EAA0E;IAC1E,UAAU,EAAE,qBAAqB,CAAC;IAClC,0HAA0H;IAC1H,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;IAC9B,yIAAyI;IACzI,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,aAAa,CAAC;IAC1C,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE;QACpB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,aAAa,CAAC;KACxB,KAAK,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;CACpE;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAInD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EACjD,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,EAC9B,QAAQ,EAAE,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,GAC9C,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CA8D1B;AAgBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EACrD,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,EAC9B,QAAQ,EAAE,0BAA0B,CAAC,KAAK,EAAE,MAAM,CAAC,GAClD,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CA4E1B"}

package/dist/connect/local-agent-tool.js

@@ -1,4 +1,7 @@
 import { CONNECT_DECISION, classifyConnectOperation, } from "./classifier.js";
+import { CONNECT_TOOL_DECISION, classifyConnectTool, } from "./tool-classifier.js";
+import { resolveConnectToolOperationIdentity, } from "./identity.js";
+import { resolveConnectToolEffectPayload, } from "./payload.js";
 import { protectLocal, } from "../local.js";
 export class AgentToolConnectionError extends Error {
     code;
@@ -8,15 +11,6 @@ export class AgentToolConnectionError extends Error {
         this.name = "AgentToolConnectionError";
     }
 }
-/**
- * Connect one registered agent tool to Once. The agent calls execute normally;
- * classification happens for every invocation without a model-side Once call.
- *
- * The tool owner must review the safety declaration, identity and effect
- * payload. This same-machine path never auto-discovers arbitrary tools and
- * cannot coordinate hosts with separate SQLite files. Supply only the
- * returned tool to the agent; an exposed original tool remains a bypass.
- */
 export function connectLocalAgentTool(tool, contract) {
     if (!tool || typeof tool.execute !== "function") {
         throw new AgentToolConnectionError("INVALID_TOOL", "Once needs a tool with an execute(input) function.");
@@ -56,4 +50,82 @@ export function connectLocalAgentTool(tool, contract) {
         execute: (input) => protectedExecute(input),
     };
 }
+const AUTO_PROTECTED_SAFETY = Object.freeze({
+    changesExternalState: true,
+    retryPossible: true,
+    ambiguousOutcomePossible: true,
+    duplicateUndesirable: true,
+});
+const AUTO_BYPASS_SAFETY = Object.freeze({
+    changesExternalState: false,
+    retryPossible: false,
+    ambiguousOutcomePossible: false,
+    duplicateUndesirable: false,
+});
+/**
+ * Connect a local agent tool using its descriptor instead of hand-authored
+ * routing declarations.
+ *
+ * Automatic routing is intentionally conservative:
+ * - PROTECT -> delegate to the existing protected local connector;
+ * - BYPASS -> delegate to the existing bypass path;
+ * - UNKNOWN -> refuse connection until the tool is clarified.
+ *
+ * For protected tools, stable identity may be supplied by `id()` or resolved
+ * from trustworthy operation/idempotency/intent carriers. Effect payload may
+ * be supplied by `payload()` or conservatively bound from the full plain-object
+ * input. `_meta.once.effectFields` can explicitly narrow that binding.
+ * Missing/invalid identity or payload fails before the side effect.
+ */
+export function connectLocalAgentToolAuto(tool, contract) {
+    if (!contract || !contract.descriptor) {
+        throw new AgentToolConnectionError("UNKNOWN_TOOL_SAFETY", "Once Connect needs a tool descriptor before automatic routing can be established.");
+    }
+    const classification = classifyConnectTool(contract.descriptor);
+    if (classification.decision === CONNECT_TOOL_DECISION.UNKNOWN) {
+        throw new AgentToolConnectionError("UNKNOWN_TOOL_SAFETY", `Once Connect cannot safely auto-route ${contract.descriptor.name || "this tool"}: ${classification.reason}.`);
+    }
+    if (classification.decision === CONNECT_TOOL_DECISION.BYPASS) {
+        return connectLocalAgentTool(tool, {
+            name: contract.descriptor.name,
+            safety: AUTO_BYPASS_SAFETY,
+            statePath: contract.statePath,
+        });
+    }
+    const identity = typeof contract.id === "function"
+        ? contract.id
+        : (input) => {
+            const result = resolveConnectToolOperationIdentity({
+                tool: contract.descriptor,
+                input,
+            });
+            if (result.status === "FOUND") {
+                return result.operationId;
+            }
+            if (result.status === "CONFLICT") {
+                throw new AgentToolConnectionError("IDENTITY_CONFLICT", result.reason);
+            }
+            throw new AgentToolConnectionError("IDENTITY_REQUIRED", result.reason);
+        };
+    const payload = typeof contract.payload === "function"
+        ? contract.payload
+        : (input) => {
+            const result = resolveConnectToolEffectPayload({
+                tool: contract.descriptor,
+                input,
+            });
+            if (result.status === "FOUND") {
+                return { ...result.payload };
+            }
+            throw new AgentToolConnectionError("PAYLOAD_REQUIRED", result.reason);
+        };
+    return connectLocalAgentTool(tool, {
+        name: contract.descriptor.name,
+        safety: AUTO_PROTECTED_SAFETY,
+        id: identity,
+        payload,
+        statePath: contract.statePath,
+        reconcile: contract.reconcile,
+    });
+}
 //# sourceMappingURL=local-agent-tool.js.map

package/dist/connect/local-agent-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-agent-tool.js","sourceRoot":"","sources":["../../src/connect/local-agent-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,wBAAwB,GAEzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,YAAY,GAEb,MAAM,aAAa,CAAC;AA0BrB,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAC5B;IAArB,YAAqB,IAAY,EAAE,OAAe;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QADI,SAAI,GAAJ,IAAI,CAAQ;QAE/B,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAA8B,EAC9B,QAA+C;IAE/C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAChD,MAAM,IAAI,wBAAwB,CAChC,cAAc,EACd,oDAAoD,CACrD,CAAC;IACJ,CAAC;IAED,IACE,CAAC,QAAQ;QACT,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ;QACjC,CAAC,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC7C,CAAC;QACD,MAAM,IAAI,wBAAwB,CAChC,mBAAmB,EACnB,4CAA4C,CAC7C,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,wBAAwB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjE,IAAI,cAAc,CAAC,QAAQ,KAAK,gBAAgB,CAAC,MAAM,EAAE,CAAC;QACxD,MAAM,IAAI,wBAAwB,CAChC,4BAA4B,EAC5B,oEAAoE,CACrE,CAAC;IACJ,CAAC;IAED,IAAI,cAAc,CAAC,QAAQ,KAAK,gBAAgB,CAAC,MAAM,EAAE,CAAC;QACxD,OAAO;YACL,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;SACnD,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,QAAQ,CAAC,EAAE,KAAK,UAAU,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAChF,MAAM,IAAI,wBAAwB,CAChC,qBAAqB,EACrB,8GAA8G,CAC/G,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAE3B,MAAM,gBAAgB,GAAG,YAAY,CACnC,KAAK,EAAE,KAAY,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EACtD;QACE,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE;YACZ,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;YACzB,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;gBACvD,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,EAAE;gBACrB,CAAC,CAAC,EAAE,CAAC;QACT,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5D,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,SAAS,EAAE,QAAQ,CAAC,SAAS;KAC9B,CACF,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC;KAC5C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"local-agent-tool.js","sourceRoot":"","sources":["../../src/connect/local-agent-tool.ts"],"names":[],"mappings":"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"}