@jini-ai/agentic 0.1.0

package/dist/webmcp.js

@@ -0,0 +1,67 @@
+/** Thrown in place of executing, when a call needed confirmation and did not get it. */
+export class WebMcpConfirmationRequiredError extends Error {
+    capabilityId;
+    reason;
+    constructor(capabilityId, reason) {
+        super(reason === 'declined'
+            ? `WebMCP: "${capabilityId}" was declined by the user`
+            : `WebMCP: "${capabilityId}" requires confirmation, but no requestUserInteraction handler was supplied`);
+        this.capabilityId = capabilityId;
+        this.reason = reason;
+        this.name = 'WebMcpConfirmationRequiredError';
+    }
+}
+/**
+ * Projects one capability into a WebMCP registration.
+ *
+ * **The confirmation gate is fail-closed.** A capability with `requiresConfirmation` will not run
+ * unless `options.requestUserInteraction` is supplied *and* resolves `true`. Omitting the handler
+ * does not silently downgrade to "just run it" — it makes the tool permanently refuse, which is
+ * the only safe reading of a manifest that asked for confirmation.
+ *
+ * This does not make WebMCP governed. It is a page-local gate over a path that still has no run,
+ * no principal, no `ToolExecutor` and no audit trail (see this package's `frontend-session-registry`
+ * note and §11 of the capability report). It closes the *accidental* case — a destructive
+ * capability reaching the page with nothing in front of it — not the authorization gap.
+ *
+ * @param capability - The capability to expose.
+ * @param execute - Runs the capability. Receives the raw argument object; the caller is
+ * responsible for validating it against `capability.inputSchema` — WebMCP does not.
+ * @param options - Optional confirmation handler; required in practice for any capability
+ * declaring `requiresConfirmation`.
+ * @returns The registration object to hand to `registerTool`.
+ * @throws {@link WebMcpConfirmationRequiredError} from `execute`, when confirmation is required
+ * and is either declined or unobtainable.
+ */
+export function toWebMcpTool(capability, execute, options = {}) {
+    return {
+        name: capability.id,
+        description: capability.description,
+        inputSchema: capability.inputSchema,
+        execute: async (args) => {
+            const input = args ?? {};
+            if (capability.requiresConfirmation === true) {
+                const { requestUserInteraction } = options;
+                if (!requestUserInteraction) {
+                    throw new WebMcpConfirmationRequiredError(capability.id, 'no-handler');
+                }
+                const approved = await requestUserInteraction({ capability, args: input });
+                if (approved !== true) {
+                    throw new WebMcpConfirmationRequiredError(capability.id, 'declined');
+                }
+            }
+            return execute(capability.id, input);
+        },
+    };
+}
+/**
+ * Projects a whole manifest.
+ *
+ * @param capabilities - Capabilities to expose, already filtered by whatever policy applies.
+ * @param execute - Shared dispatcher, keyed by capability id.
+ * @returns One registration per capability, in manifest order.
+ */
+export function toWebMcpTools(capabilities, execute, options = {}) {
+    return capabilities.map((capability) => toWebMcpTool(capability, execute, options));
+}
+//# sourceMappingURL=webmcp.js.map

package/dist/webmcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp.js","sourceRoot":"","sources":["../src/webmcp.ts"],"names":[],"mappings":"AAgDA,wFAAwF;AACxF,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IACnC;IAA+B;IAApD,YAAqB,YAAoB,EAAW,MAAiC;QACnF,KAAK,CACH,MAAM,KAAK,UAAU;YACnB,CAAC,CAAC,YAAY,YAAY,4BAA4B;YACtD,CAAC,CAAC,YAAY,YAAY,6EAA6E,CAC1G,CAAC;QALiB,iBAAY,GAAZ,YAAY,CAAQ;QAAW,WAAM,GAAN,MAAM,CAA2B;QAMnF,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;IAChD,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,YAAY,CAC1B,UAAyB,EACzB,OAAwE,EACxE,UAA+B,EAAE;IAEjC,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,EAAE;QACnB,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;YACzB,IAAI,UAAU,CAAC,oBAAoB,KAAK,IAAI,EAAE,CAAC;gBAC7C,MAAM,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC;gBAC3C,IAAI,CAAC,sBAAsB,EAAE,CAAC;oBAC5B,MAAM,IAAI,+BAA+B,CAAC,UAAU,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;gBACzE,CAAC;gBACD,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC3E,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;oBACtB,MAAM,IAAI,+BAA+B,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;gBACvE,CAAC;YACH,CAAC;YACD,OAAO,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,YAAsC,EACtC,OAAwE,EACxE,UAA+B,EAAE;IAEjC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AACtF,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@jini-ai/agentic",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AINSEP/Jini.git",
+    "directory": "packages/agentic"
+  },
+  "jini": {
+    "domain": "agent",
+    "kind": "capability-surface",
+    "runtime": "universal",
+    "admission": "admitted",
+    "entries": {
+      ".": "universal",
+      "./dom": "browser"
+    }
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./dom": {
+      "types": "./dist/dom/index.d.ts",
+      "import": "./dist/dom/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map",
+    "!dist/**/__tests__/**"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "@jini-ai/protocol": "0.1.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^2.1.9",
+    "jsdom": "^25.0.1"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.dom.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.dom.json --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
+  }
+}