@jini-ai/mcp 0.3.3 → 0.4.0

package/dist/tools/ask-choice/schema.d.ts

@@ -0,0 +1,91 @@
+/** Model input schema. Callback correlation params are carried by the rendered form only. */
+export declare const ASK_CHOICE_INPUT_SCHEMA: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["title"];
+    readonly anyOf: readonly [{
+        readonly required: readonly ["singleSelect"];
+    }, {
+        readonly required: readonly ["multiSelect"];
+    }];
+    readonly properties: {
+        readonly title: {
+            readonly type: "string";
+        };
+        readonly description: {
+            readonly type: "string";
+        };
+        readonly submitLabel: {
+            readonly type: "string";
+        };
+        readonly singleSelect: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["label", "options"];
+            readonly properties: {
+                readonly label: {
+                    readonly type: "string";
+                };
+                readonly options: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["value", "label"];
+                        readonly properties: {
+                            readonly value: {
+                                readonly type: "string";
+                            };
+                            readonly label: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly multiSelect: {
+            readonly properties: {
+                readonly hint: {
+                    readonly type: "string";
+                };
+                readonly label: {
+                    readonly type: "string";
+                };
+                readonly options: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["value", "label"];
+                        readonly properties: {
+                            readonly value: {
+                                readonly type: "string";
+                            };
+                            readonly label: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                };
+            };
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["label", "options"];
+        };
+        readonly choice: {
+            readonly type: "string";
+            readonly description: "Set by the rendered form; never by the model.";
+        };
+        readonly selections: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly description: "Set by the rendered form; never by the model.";
+        };
+    };
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/tools/ask-choice/schema.js

@@ -0,0 +1,27 @@
+const optionSchema = {
+    type: 'object', additionalProperties: false, required: ['value', 'label'],
+    properties: { value: { type: 'string' }, label: { type: 'string' } },
+};
+const selectSchema = {
+    type: 'object', additionalProperties: false, required: ['label', 'options'],
+    properties: {
+        label: { type: 'string' },
+        options: { type: 'array', minItems: 1, items: optionSchema },
+    },
+};
+/** Model input schema. Callback correlation params are carried by the rendered form only. */
+export const ASK_CHOICE_INPUT_SCHEMA = {
+    type: 'object', additionalProperties: false, required: ['title'],
+    anyOf: [{ required: ['singleSelect'] }, { required: ['multiSelect'] }],
+    properties: {
+        title: { type: 'string' }, description: { type: 'string' }, submitLabel: { type: 'string' },
+        singleSelect: selectSchema,
+        multiSelect: {
+            ...selectSchema,
+            properties: { ...selectSchema.properties, hint: { type: 'string' } },
+        },
+        choice: { type: 'string', description: 'Set by the rendered form; never by the model.' },
+        selections: { type: 'array', items: { type: 'string' }, description: 'Set by the rendered form; never by the model.' },
+    },
+};
+//# sourceMappingURL=schema.js.map

package/dist/tools/ask-choice/types.d.ts

@@ -0,0 +1,106 @@
+/** Product-neutral question content; rendering and copy belong to the host. */
+export interface AskChoiceSelect {
+    readonly label: string;
+    readonly hint?: string;
+    readonly options: ReadonlyArray<{
+        value: string;
+        label: string;
+    }>;
+}
+export interface AskChoiceQuestion {
+    readonly title: string;
+    readonly description?: string;
+    readonly submitLabel?: string;
+    readonly singleSelect?: AskChoiceSelect;
+    readonly multiSelect?: AskChoiceSelect;
+}
+export interface AskChoiceMessages {
+    readonly pending: string;
+    readonly forgedAnswer: string;
+    readonly submitted: string;
+    readonly typed: string;
+    readonly noAnswer: string;
+    readonly cancelled: string;
+    readonly expired: string;
+    readonly abandoned: string;
+}
+export type AskChoiceMessage = {
+    status: 'received';
+    params: Record<string, unknown>;
+} | {
+    status: 'expired' | 'abandoned';
+};
+export interface AskChoiceEmission {
+    channel: 'mcp-ui';
+    payload: {
+        resource: unknown;
+    };
+}
+export type AskChoiceEmitter = (args: {
+    emission: AskChoiceEmission;
+}) => Promise<void>;
+/** The host owns correlation, principal binding, buffering, and expiry of live exchanges. */
+export interface AskChoiceExchange {
+    readonly id: string;
+    send(args: {
+        emission: AskChoiceEmission;
+    }): Promise<void>;
+    receive(args: Record<string, never>): Promise<AskChoiceMessage>;
+    close(args: Record<string, never>): void;
+}
+export interface AskChoiceExchangeStore {
+    open(args: {
+        toolId: string;
+        principalId: string;
+        emit: AskChoiceEmitter;
+    }): AskChoiceExchange;
+}
+/** Redeem consumes before checking binding, time, and offered options; rejection is fail-closed. */
+export interface AskChoicePendingStore {
+    mint(args: {
+        principalId: string;
+        question: AskChoiceQuestion;
+    }): string;
+    redeem(args: {
+        ticket: string | undefined;
+        principalId: string;
+        params: Record<string, unknown>;
+    }): boolean;
+}
+export interface AskChoiceCall {
+    principalId: string;
+    input: unknown;
+    signal: AbortSignal;
+    emitSurface?: AskChoiceEmitter;
+}
+/** Authorization is invoked before either displaying a question or redeeming its answer. */
+export interface AskChoicePolicy {
+    authorize(args: {
+        ctx: AskChoiceCall;
+        toolId: string;
+    }): void | Promise<void>;
+    inputError(args: {
+        message: string;
+    }): Error;
+    shapeError(args: {
+        message: string;
+        toolId: string;
+        inputSchema: Readonly<Record<string, unknown>>;
+    }): Error;
+}
+export interface AskChoiceForm {
+    toolName: string;
+    principalId: string;
+    question: AskChoiceQuestion;
+    baseParams: Record<string, unknown>;
+    cancelParams?: Record<string, unknown>;
+}
+/** The host supplies resource identity, labels, field presentation, app metadata, and result encoding. */
+export interface AskChoicePresentation {
+    render(args: Omit<AskChoiceForm, 'cancelParams'>, options?: Pick<AskChoiceForm, 'cancelParams'>): unknown;
+    buildResult(args: {
+        modelText: string;
+        ui: unknown;
+    }): Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/ask-choice/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jini-ai/mcp",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Model Context Protocol adapters: server config schema and IO, an MCP client, and agent-side MCP server installation.",
   "license": "Apache-2.0",
   "repository": {
@@ -11,7 +11,16 @@
   "jini": {
     "domain": "integration",
     "kind": "protocol-adapter",
-    "runtime": "node"
+    "runtime": "node",
+    "entries": {
+      ".": "node",
+      "./bin": "node",
+      "./tools/ask-choice": "universal",
+      "./federation": "node",
+      "./federation/approvals": "node",
+      "./federation/stdio": "node",
+      "./federation/testing": "universal"
+    }
   },
   "type": "module",
   "sideEffects": false,
@@ -23,7 +32,34 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./tools/ask-choice": {
+      "types": "./dist/tools/ask-choice/index.d.ts",
+      "import": "./dist/tools/ask-choice/index.js",
+      "default": "./dist/tools/ask-choice/index.js"
+    },
+    "./federation": {
+      "types": "./dist/federation/index.d.ts",
+      "import": "./dist/federation/index.js",
+      "default": "./dist/federation/index.js"
+    },
+    "./federation/approvals": {
+      "types": "./dist/federation/approvals/index.d.ts",
+      "import": "./dist/federation/approvals/index.js",
+      "default": "./dist/federation/approvals/index.js"
+    },
+    "./federation/stdio": {
+      "types": "./dist/federation/stdio/index.d.ts",
+      "import": "./dist/federation/stdio/index.js",
+      "default": "./dist/federation/stdio/index.js"
+    },
+    "./federation/testing": {
+      "types": "./dist/federation/testing/index.d.ts",
+      "import": "./dist/federation/testing/index.js",
+      "default": "./dist/federation/testing/index.js"
+    },
     "./bin": {
+      "types": "./dist/bin/serve.d.ts",
+      "import": "./dist/bin/serve.js",
       "default": "./dist/bin/serve.js"
     }
   },
@@ -32,6 +68,9 @@
   },
   "files": [
     "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
     "!dist/**/*.test.js",
     "!dist/**/*.test.d.ts",
     "!dist/**/*.test.js.map",
@@ -46,9 +85,8 @@
   "dependencies": {
     "@cfworker/json-schema": "^4.1.1",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "undici": "^7.25.0",
-    "@jini-ai/cli": "0.3.0",
-    "@jini-ai/platform": "0.3.0"
+    "@jini-ai/core": "0.4.0",
+    "@jini-ai/platform": "0.5.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json && chmod +x dist/bin/serve.js",