@agent-vm/agent-portal-sdk 0.0.113 → 0.0.115

package/dist/portal-event-surface/index.js

@@ -1,51 +1,3 @@
-import { a as ItemIdSchema, i as SafeDiagnosticSchema, n as PortalErrorSchema, r as SafeDiagnosticCodeSchema } from "../portal-error-schema-D58onG2t.js";
-import { z } from "zod";
-//#region src/portal-event-surface/models/portal-event-schema.ts
-const PortalProgressEventSchema = z.object({
-	id: ItemIdSchema,
-	kind: z.literal("progress"),
-	message: z.string().max(500),
-	percent: z.number().min(0).max(100).optional()
-}).strict();
-const PortalPartialOutputEventSchema = z.object({
-	id: ItemIdSchema,
-	kind: z.literal("partial_output"),
-	stream: z.enum([
-		"stdout",
-		"stderr",
-		"result"
-	]),
-	text: z.string().max(16384),
-	truncated: z.boolean().default(false)
-}).strict();
-const PortalDiagnosticEventSchema = z.object({
-	diagnostic: SafeDiagnosticSchema,
-	id: ItemIdSchema,
-	kind: z.literal("diagnostic")
-}).strict();
-const PortalCancellationRequestEventSchema = z.object({
-	id: ItemIdSchema,
-	kind: z.literal("cancellation_requested"),
-	reason: z.string().max(500).optional()
-}).strict();
-const PortalCancellationResultEventSchema = z.object({
-	error: PortalErrorSchema.optional(),
-	id: ItemIdSchema,
-	kind: z.literal("cancellation_result"),
-	status: z.enum([
-		"cancelled",
-		"not_found",
-		"already_finished"
-	])
-}).strict();
-const PortalEventSchema = z.discriminatedUnion("kind", [
-	PortalProgressEventSchema,
-	PortalPartialOutputEventSchema,
-	PortalDiagnosticEventSchema,
-	PortalCancellationRequestEventSchema,
-	PortalCancellationResultEventSchema
-]);
-//#endregion
+import { i as SafeDiagnosticSchema, r as SafeDiagnosticCodeSchema } from "../portal-error-schema-CQHgoFq4.js";
+import { a as PortalPartialOutputEventSchema, i as PortalEventSchema, n as PortalCancellationResultEventSchema, o as PortalProgressEventSchema, r as PortalDiagnosticEventSchema, t as PortalCancellationRequestEventSchema } from "../portal-event-surface-CdScrgoN.js";
 export { PortalCancellationRequestEventSchema, PortalCancellationResultEventSchema, PortalDiagnosticEventSchema, PortalEventSchema, PortalPartialOutputEventSchema, PortalProgressEventSchema, SafeDiagnosticCodeSchema, SafeDiagnosticSchema };
-
-//# sourceMappingURL=index.js.map

package/dist/portal-event-surface-CdScrgoN.js

@@ -0,0 +1,51 @@
+import { a as ItemIdSchema, i as SafeDiagnosticSchema, n as PortalErrorSchema } from "./portal-error-schema-CQHgoFq4.js";
+import { z } from "zod";
+//#region src/portal-event-surface/models/portal-event-schema.ts
+const PortalProgressEventSchema = z.object({
+	id: ItemIdSchema,
+	kind: z.literal("progress"),
+	message: z.string().max(500),
+	percent: z.number().min(0).max(100).optional()
+}).strict();
+const PortalPartialOutputEventSchema = z.object({
+	id: ItemIdSchema,
+	kind: z.literal("partial_output"),
+	stream: z.enum([
+		"stdout",
+		"stderr",
+		"result"
+	]),
+	text: z.string().max(16384),
+	truncated: z.boolean().default(false)
+}).strict();
+const PortalDiagnosticEventSchema = z.object({
+	diagnostic: SafeDiagnosticSchema,
+	id: ItemIdSchema,
+	kind: z.literal("diagnostic")
+}).strict();
+const PortalCancellationRequestEventSchema = z.object({
+	id: ItemIdSchema,
+	kind: z.literal("cancellation_requested"),
+	reason: z.string().max(500).optional()
+}).strict();
+const PortalCancellationResultEventSchema = z.object({
+	error: PortalErrorSchema.optional(),
+	id: ItemIdSchema,
+	kind: z.literal("cancellation_result"),
+	status: z.enum([
+		"cancelled",
+		"not_found",
+		"already_finished"
+	])
+}).strict();
+const PortalEventSchema = z.discriminatedUnion("kind", [
+	PortalProgressEventSchema,
+	PortalPartialOutputEventSchema,
+	PortalDiagnosticEventSchema,
+	PortalCancellationRequestEventSchema,
+	PortalCancellationResultEventSchema
+]);
+//#endregion
+export { PortalPartialOutputEventSchema as a, PortalEventSchema as i, PortalCancellationResultEventSchema as n, PortalProgressEventSchema as o, PortalDiagnosticEventSchema as r, PortalCancellationRequestEventSchema as t };
+
+//# sourceMappingURL=portal-event-surface-CdScrgoN.js.map

package/dist/portal-event-surface-CdScrgoN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-event-surface-CdScrgoN.js","names":[],"sources":["../src/portal-event-surface/models/portal-event-schema.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { ItemIdSchema } from '../../contract-primitives/models/request-id-schema.js';\nimport { PortalErrorSchema } from '../../portal-call-surface/models/portal-error-schema.js';\nimport { SafeDiagnosticSchema } from './safe-diagnostic-schema.js';\n\nexport const PortalProgressEventSchema = z\n\t.object({\n\t\tid: ItemIdSchema,\n\t\tkind: z.literal('progress'),\n\t\tmessage: z.string().max(500),\n\t\tpercent: z.number().min(0).max(100).optional(),\n\t})\n\t.strict();\n\nexport type PortalProgressEvent = z.infer<typeof PortalProgressEventSchema>;\n\nexport const PortalPartialOutputEventSchema = z\n\t.object({\n\t\tid: ItemIdSchema,\n\t\tkind: z.literal('partial_output'),\n\t\tstream: z.enum(['stdout', 'stderr', 'result']),\n\t\ttext: z.string().max(16_384),\n\t\ttruncated: z.boolean().default(false),\n\t})\n\t.strict();\n\nexport type PortalPartialOutputEvent = z.infer<typeof PortalPartialOutputEventSchema>;\n\nexport const PortalDiagnosticEventSchema = z\n\t.object({\n\t\tdiagnostic: SafeDiagnosticSchema,\n\t\tid: ItemIdSchema,\n\t\tkind: z.literal('diagnostic'),\n\t})\n\t.strict();\n\nexport type PortalDiagnosticEvent = z.infer<typeof PortalDiagnosticEventSchema>;\n\nexport const PortalCancellationRequestEventSchema = z\n\t.object({\n\t\tid: ItemIdSchema,\n\t\tkind: z.literal('cancellation_requested'),\n\t\treason: z.string().max(500).optional(),\n\t})\n\t.strict();\n\nexport type PortalCancellationRequestEvent = z.infer<typeof PortalCancellationRequestEventSchema>;\n\nexport const PortalCancellationResultEventSchema = z\n\t.object({\n\t\terror: PortalErrorSchema.optional(),\n\t\tid: ItemIdSchema,\n\t\tkind: z.literal('cancellation_result'),\n\t\tstatus: z.enum(['cancelled', 'not_found', 'already_finished']),\n\t})\n\t.strict();\n\nexport type PortalCancellationResultEvent = z.infer<typeof PortalCancellationResultEventSchema>;\n\nexport const PortalEventSchema = z.discriminatedUnion('kind', [\n\tPortalProgressEventSchema,\n\tPortalPartialOutputEventSchema,\n\tPortalDiagnosticEventSchema,\n\tPortalCancellationRequestEventSchema,\n\tPortalCancellationResultEventSchema,\n]);\n\nexport type PortalEvent = z.infer<typeof PortalEventSchema>;\n"],"mappings":";;;AAMA,MAAa,4BAA4B,EACvC,OAAO;CACP,IAAI;CACJ,MAAM,EAAE,QAAQ,WAAW;CAC3B,SAAS,EAAE,QAAQ,CAAC,IAAI,IAAI;CAC5B,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU;CAC9C,CAAC,CACD,QAAQ;AAIV,MAAa,iCAAiC,EAC5C,OAAO;CACP,IAAI;CACJ,MAAM,EAAE,QAAQ,iBAAiB;CACjC,QAAQ,EAAE,KAAK;EAAC;EAAU;EAAU;EAAS,CAAC;CAC9C,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAO;CAC5B,WAAW,EAAE,SAAS,CAAC,QAAQ,MAAM;CACrC,CAAC,CACD,QAAQ;AAIV,MAAa,8BAA8B,EACzC,OAAO;CACP,YAAY;CACZ,IAAI;CACJ,MAAM,EAAE,QAAQ,aAAa;CAC7B,CAAC,CACD,QAAQ;AAIV,MAAa,uCAAuC,EAClD,OAAO;CACP,IAAI;CACJ,MAAM,EAAE,QAAQ,yBAAyB;CACzC,QAAQ,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,UAAU;CACtC,CAAC,CACD,QAAQ;AAIV,MAAa,sCAAsC,EACjD,OAAO;CACP,OAAO,kBAAkB,UAAU;CACnC,IAAI;CACJ,MAAM,EAAE,QAAQ,sBAAsB;CACtC,QAAQ,EAAE,KAAK;EAAC;EAAa;EAAa;EAAmB,CAAC;CAC9D,CAAC,CACD,QAAQ;AAIV,MAAa,oBAAoB,EAAE,mBAAmB,QAAQ;CAC7D;CACA;CACA;CACA;CACA;CACA,CAAC"}

package/dist/testing/index.d.ts

@@ -1,6 +1,5 @@
-import { l as JsonValue, r as JsonObject } from "../json-value-schema-Bj42URkc.js";
-import { b as PortalCallRequest, n as PortalCallResult } from "../portal-call-result-schema-DjpKPcE_.js";
-
+import { l as JsonValue, r as JsonObject } from "../json-value-schema-M87sjwWL.js";
+import { S as PortalCallRequest, i as PortalCallResult } from "../portal-call-result-schema-wSCaz3mC.js";
 //#region src/testing/index.d.ts
 interface CreatePortalCallRequestFixtureProps {
   readonly arguments?: JsonObject;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/testing/index.ts"],"mappings":";;;;UAUiB,mCAAA;EAAA,SACP,SAAA,GAAY,UAAA;EAAA,SACZ,EAAA;EAAA,SACA,SAAA;EAAA,SACA,SAAA;EAAA,SACA,IAAA;AAAA;AAAA,UAGO,kCAAA;EAAA,SACP,EAAA;EAAA,SACA,KAAA,GAAQ,SAAA;AAAA;AAAA,iBAGF,8BAAA,CACf,KAAA,GAAO,mCAAA,GACL,iBAAA;AAAA,iBAca,6BAAA,CACf,KAAA,GAAO,kCAAA,GACL,gBAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/testing/index.ts"],"mappings":";;;UAUiB,mCAAA;EAAA,SACP,SAAA,GAAY,UAAA;EAAA,SACZ,EAAA;EAAA,SACA,SAAA;EAAA,SACA,SAAA;EAAA,SACA,IAAA;AAAA;AAAA,UAGO,kCAAA;EAAA,SACP,EAAA;EAAA,SACA,KAAA,GAAQ,SAAA;AAAA;AAAA,iBAGF,8BAAA,CACf,KAAA,GAAO,mCAAA,GACL,iBAAA;AAAA,iBAca,6BAAA,CACf,KAAA,GAAO,kCAAA,GACL,gBAAA"}

package/dist/testing/index.js

@@ -1,4 +1,5 @@
-import { g as PortalCallRequestSchema, n as PortalCallResultSchema } from "../portal-call-result-schema-BIqFTFK8.js";
+import { i as PortalCallResultSchema } from "../portal-call-result-schema-ByxHRCEN.js";
+import { r as PortalCallRequestSchema } from "../portal-call-request-schema-Cp6CMGs9.js";
 //#region src/testing/index.ts
 function createPortalCallRequestFixture(props = {}) {
 	return PortalCallRequestSchema.parse({
@@ -15,6 +16,14 @@ function createPortalCallResultFixture(props = {}) {
 	return PortalCallResultSchema.parse({
 		items: [{
 			id: props.id ?? "call-1",
+			operationId: "operation-1",
+			outcome: {
+				certainty: "proven",
+				completion: "succeeded",
+				kind: "completed",
+				retryClass: "forbidden"
+			},
+			owningGeneration: "tool-vm-generation-1",
 			status: "ok",
 			value: props.value ?? {}
 		}],

package/dist/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/testing/index.ts"],"sourcesContent":["import type { JsonObject, JsonValue } from '../contract-primitives/index.js';\nimport {\n\tPortalCallRequestSchema,\n\ttype PortalCallRequest,\n} from '../portal-call-surface/models/portal-call-request-schema.js';\nimport {\n\tPortalCallResultSchema,\n\ttype PortalCallResult,\n} from '../portal-call-surface/models/portal-call-result-schema.js';\n\nexport interface CreatePortalCallRequestFixtureProps {\n\treadonly arguments?: JsonObject;\n\treadonly id?: string;\n\treadonly namespace?: string;\n\treadonly requestId?: string;\n\treadonly name?: string;\n}\n\nexport interface CreatePortalCallResultFixtureProps {\n\treadonly id?: string;\n\treadonly value?: JsonValue;\n}\n\nexport function createPortalCallRequestFixture(\n\tprops: CreatePortalCallRequestFixtureProps = {},\n): PortalCallRequest {\n\treturn PortalCallRequestSchema.parse({\n\t\tcalls: [\n\t\t\t{\n\t\t\t\targuments: props.arguments ?? {},\n\t\t\t\tid: props.id ?? 'call-1',\n\t\t\t\tnamespace: props.namespace ?? 'github',\n\t\t\t\tname: props.name ?? 'get_issue',\n\t\t\t},\n\t\t],\n\t\trequestId: props.requestId,\n\t});\n}\n\nexport function createPortalCallResultFixture(\n\tprops: CreatePortalCallResultFixtureProps = {},\n): PortalCallResult {\n\treturn PortalCallResultSchema.parse({\n\t\titems: [\n\t\t\t{\n\t\t\t\tid: props.id ?? 'call-1',\n\t\t\t\tstatus: 'ok',\n\t\t\t\tvalue: props.value ?? {},\n\t\t\t},\n\t\t],\n\t\tok: true,\n\t});\n}\n"],"mappings":";;AAuBA,SAAgB,+BACf,QAA6C,EAAE,EAC3B;CACpB,OAAO,wBAAwB,MAAM;EACpC,OAAO,CACN;GACC,WAAW,MAAM,aAAa,EAAE;GAChC,IAAI,MAAM,MAAM;GAChB,WAAW,MAAM,aAAa;GAC9B,MAAM,MAAM,QAAQ;GACpB,CACD;EACD,WAAW,MAAM;EACjB,CAAC;;AAGH,SAAgB,8BACf,QAA4C,EAAE,EAC3B;CACnB,OAAO,uBAAuB,MAAM;EACnC,OAAO,CACN;GACC,IAAI,MAAM,MAAM;GAChB,QAAQ;GACR,OAAO,MAAM,SAAS,EAAE;GACxB,CACD;EACD,IAAI;EACJ,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/testing/index.ts"],"sourcesContent":["import type { JsonObject, JsonValue } from '../contract-primitives/index.js';\nimport {\n\tPortalCallRequestSchema,\n\ttype PortalCallRequest,\n} from '../portal-call-surface/models/portal-call-request-schema.js';\nimport {\n\tPortalCallResultSchema,\n\ttype PortalCallResult,\n} from '../portal-call-surface/models/portal-call-result-schema.js';\n\nexport interface CreatePortalCallRequestFixtureProps {\n\treadonly arguments?: JsonObject;\n\treadonly id?: string;\n\treadonly namespace?: string;\n\treadonly requestId?: string;\n\treadonly name?: string;\n}\n\nexport interface CreatePortalCallResultFixtureProps {\n\treadonly id?: string;\n\treadonly value?: JsonValue;\n}\n\nexport function createPortalCallRequestFixture(\n\tprops: CreatePortalCallRequestFixtureProps = {},\n): PortalCallRequest {\n\treturn PortalCallRequestSchema.parse({\n\t\tcalls: [\n\t\t\t{\n\t\t\t\targuments: props.arguments ?? {},\n\t\t\t\tid: props.id ?? 'call-1',\n\t\t\t\tnamespace: props.namespace ?? 'github',\n\t\t\t\tname: props.name ?? 'get_issue',\n\t\t\t},\n\t\t],\n\t\trequestId: props.requestId,\n\t});\n}\n\nexport function createPortalCallResultFixture(\n\tprops: CreatePortalCallResultFixtureProps = {},\n): PortalCallResult {\n\treturn PortalCallResultSchema.parse({\n\t\titems: [\n\t\t\t{\n\t\t\t\tid: props.id ?? 'call-1',\n\t\t\t\toperationId: 'operation-1',\n\t\t\t\toutcome: {\n\t\t\t\t\tcertainty: 'proven',\n\t\t\t\t\tcompletion: 'succeeded',\n\t\t\t\t\tkind: 'completed',\n\t\t\t\t\tretryClass: 'forbidden',\n\t\t\t\t},\n\t\t\t\towningGeneration: 'tool-vm-generation-1',\n\t\t\t\tstatus: 'ok',\n\t\t\t\tvalue: props.value ?? {},\n\t\t\t},\n\t\t],\n\t\tok: true,\n\t});\n}\n"],"mappings":";;;AAuBA,SAAgB,+BACf,QAA6C,EAAE,EAC3B;CACpB,OAAO,wBAAwB,MAAM;EACpC,OAAO,CACN;GACC,WAAW,MAAM,aAAa,EAAE;GAChC,IAAI,MAAM,MAAM;GAChB,WAAW,MAAM,aAAa;GAC9B,MAAM,MAAM,QAAQ;GACpB,CACD;EACD,WAAW,MAAM;EACjB,CAAC;;AAGH,SAAgB,8BACf,QAA4C,EAAE,EAC3B;CACnB,OAAO,uBAAuB,MAAM;EACnC,OAAO,CACN;GACC,IAAI,MAAM,MAAM;GAChB,aAAa;GACb,SAAS;IACR,WAAW;IACX,YAAY;IACZ,MAAM;IACN,YAAY;IACZ;GACD,kBAAkB;GAClB,QAAQ;GACR,OAAO,MAAM,SAAS,EAAE;GACxB,CACD;EACD,IAAI;EACJ,CAAC"}

package/dist/tool-portal-mcp-client/index.d.ts

@@ -0,0 +1,2 @@
+import { a as ToolPortalMcpTransport, i as ToolPortalMcpResourceContent, n as ToolPortalMcpClient, r as ToolPortalMcpClientOptions, t as ToolPortalClientRequestOptions } from "../index-v8suC0qe.js";
+export { ToolPortalClientRequestOptions, ToolPortalMcpClient, ToolPortalMcpClientOptions, ToolPortalMcpResourceContent, ToolPortalMcpTransport };

package/dist/tool-portal-mcp-client/index.js

@@ -0,0 +1,2 @@
+import { t as ToolPortalMcpClient } from "../tool-portal-mcp-client-DwJF-48Y.js";
+export { ToolPortalMcpClient };

package/dist/tool-portal-mcp-client/node-tool-portal-mcp-transport.d.ts

@@ -0,0 +1,17 @@
+import { a as ToolPortalMcpTransport } from "../index-v8suC0qe.js";
+
+//#region src/tool-portal-mcp-client/node-tool-portal-mcp-transport.d.ts
+type CreateNodeToolPortalMcpTransportProps = {
+  readonly authorization: string;
+  readonly endpoint: URL;
+  readonly kind: 'http';
+} | {
+  readonly argv: readonly string[];
+  readonly executable: string;
+  readonly kind: 'scoped-stdio';
+};
+/** Standard MCP transport adapter for the portable Tool Portal client. */
+declare function createNodeToolPortalMcpTransport(props: CreateNodeToolPortalMcpTransportProps): ToolPortalMcpTransport;
+//#endregion
+export { CreateNodeToolPortalMcpTransportProps, createNodeToolPortalMcpTransport };
+//# sourceMappingURL=node-tool-portal-mcp-transport.d.ts.map

package/dist/tool-portal-mcp-client/node-tool-portal-mcp-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-tool-portal-mcp-transport.d.ts","names":[],"sources":["../../src/tool-portal-mcp-client/node-tool-portal-mcp-transport.ts"],"mappings":";;;KASY,qCAAA;EAAA,SAEA,aAAA;EAAA,SACA,QAAA,EAAU,GAAA;EAAA,SACV,IAAA;AAAA;EAAA,SAGA,IAAA;EAAA,SACA,UAAA;EAAA,SACA,IAAA;AAAA;;iBA8FI,gCAAA,CACf,KAAA,EAAO,qCAAA,GACL,sBAAA"}

package/dist/tool-portal-mcp-client/node-tool-portal-mcp-transport.js

@@ -0,0 +1,2 @@
+import { t as createNodeToolPortalMcpTransport } from "../node-tool-portal-mcp-transport-Cl2VKbLY.js";
+export { createNodeToolPortalMcpTransport };

package/dist/tool-portal-mcp-client-DwJF-48Y.js

@@ -0,0 +1,90 @@
+import { d as PortalListResultSchema, i as PortalCallResultSchema, m as PortalSearchResultSchema, s as PortalDescribeResultSchema } from "./portal-call-result-schema-ByxHRCEN.js";
+import { a as PortalArtifactReadRequestSchema, o as PortalArtifactReadResultSchema, r as createPortalArtifactReadResourceRequest } from "./artifact-surface-BstQxq6b.js";
+import { r as PortalCallRequestSchema } from "./portal-call-request-schema-Cp6CMGs9.js";
+import { a as PortalListRequestSchema, r as PortalSearchRequestSchema, s as PortalDescribeRequestSchema } from "./portal-call-surface-DjZVquFt.js";
+//#region src/tool-portal-mcp-client/index.ts
+const canonicalBase64Pattern = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/u;
+function decodedBase64ByteLength(contentBase64) {
+	if (!canonicalBase64Pattern.test(contentBase64)) throw new TypeError("Tool Portal MCP artifact content is not canonical base64.");
+	const paddingBytes = contentBase64.endsWith("==") ? 2 : contentBase64.endsWith("=") ? 1 : 0;
+	return contentBase64.length / 4 * 3 - paddingBytes;
+}
+var ToolPortalMcpArtifactOperations = class {
+	#transport;
+	constructor(transport) {
+		this.#transport = transport;
+	}
+	async read(request, options = {}) {
+		const validatedRequest = PortalArtifactReadRequestSchema.parse(request);
+		const resourceRequest = createPortalArtifactReadResourceRequest(validatedRequest);
+		const response = await this.#transport.readResource(resourceRequest, options);
+		const content = response.contents.length === 1 ? response.contents[0] : void 0;
+		if (content === void 0 || content.kind !== "blob" || content.uri !== resourceRequest.uri || content.mediaType === void 0) throw new TypeError("Tool Portal MCP artifact read returned an invalid resource.");
+		const returnedBytes = decodedBase64ByteLength(content.blob);
+		if (returnedBytes > validatedRequest.maxBytes) throw new TypeError("Tool Portal MCP artifact read exceeded the requested byte range.");
+		return PortalArtifactReadResultSchema.parse({
+			contentBase64: content.blob,
+			mediaType: content.mediaType,
+			offsetBytes: validatedRequest.offsetBytes,
+			reference: validatedRequest.reference,
+			truncated: validatedRequest.offsetBytes + returnedBytes < validatedRequest.reference.byteLength
+		});
+	}
+};
+/**
+* Standard-MCP projection of the bounded Tool Portal surface.
+*
+* The transport is injected so this subpath remains independent from the
+* Gateway-runtime UDS client and its Node-specific dependencies.
+*/
+var ToolPortalMcpClient = class {
+	#transport;
+	artifacts;
+	constructor(options) {
+		this.#transport = options.transport;
+		this.artifacts = new ToolPortalMcpArtifactOperations(this.#transport);
+	}
+	async connect() {
+		await this.#transport.connect();
+	}
+	async close() {
+		await this.#transport.close();
+	}
+	async list(request, options = {}) {
+		const validatedRequest = PortalListRequestSchema.parse(request);
+		const response = await this.#transport.callTool({
+			arguments: validatedRequest,
+			name: "tool_portal_list"
+		}, options);
+		return PortalListResultSchema.parse(response.structuredContent);
+	}
+	async search(request, options = {}) {
+		const validatedRequest = PortalSearchRequestSchema.parse(request);
+		const response = await this.#transport.callTool({
+			arguments: validatedRequest,
+			name: "tool_portal_search"
+		}, options);
+		return PortalSearchResultSchema.parse(response.structuredContent);
+	}
+	async describe(request, options = {}) {
+		const validatedRequest = PortalDescribeRequestSchema.parse(request);
+		const response = await this.#transport.callTool({
+			arguments: validatedRequest,
+			name: "tool_portal_describe"
+		}, options);
+		return PortalDescribeResultSchema.parse(response.structuredContent);
+	}
+	async call(request, options = {}) {
+		const validatedRequest = PortalCallRequestSchema.parse(request);
+		const response = await this.#transport.callTool({
+			...options.approvalToken === void 0 ? {} : { approvalToken: options.approvalToken },
+			arguments: validatedRequest,
+			name: "tool_portal_call"
+		}, options);
+		return PortalCallResultSchema.parse(response.structuredContent);
+	}
+};
+//#endregion
+export { ToolPortalMcpClient as t };
+
+//# sourceMappingURL=tool-portal-mcp-client-DwJF-48Y.js.map

package/dist/tool-portal-mcp-client-DwJF-48Y.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-portal-mcp-client-DwJF-48Y.js","names":["#transport"],"sources":["../src/tool-portal-mcp-client/index.ts"],"sourcesContent":["import {\n\tcreatePortalArtifactReadResourceRequest,\n\tPortalArtifactReadRequestSchema,\n\tPortalArtifactReadResultSchema,\n\ttype PortalArtifactReadRequest,\n\ttype PortalArtifactReadResourceRequest,\n\ttype PortalArtifactReadResult,\n} from '../artifact-surface/index.js';\nimport {\n\tPortalCallRequestSchema,\n\tPortalCallResultSchema,\n\tPortalDescribeRequestSchema,\n\tPortalDescribeResultSchema,\n\tPortalListRequestSchema,\n\tPortalListResultSchema,\n\tPortalSearchRequestSchema,\n\tPortalSearchResultSchema,\n\ttype PortalCallRequest,\n\ttype PortalCallResult,\n\ttype PortalDescribeRequest,\n\ttype PortalDescribeResult,\n\ttype PortalListRequest,\n\ttype PortalListResult,\n\ttype PortalSearchRequest,\n\ttype PortalSearchResult,\n} from '../portal-call-surface/index.js';\n\nexport type ToolPortalMcpResourceContent =\n\t| {\n\t\t\treadonly blob: string;\n\t\t\treadonly kind: 'blob';\n\t\t\treadonly mediaType?: string;\n\t\t\treadonly uri: string;\n\t  }\n\t| {\n\t\t\treadonly kind: 'text';\n\t\t\treadonly mediaType?: string;\n\t\t\treadonly text: string;\n\t\t\treadonly uri: string;\n\t  };\n\nexport interface ToolPortalMcpTransport {\n\treadonly callTool: (\n\t\tcall: {\n\t\t\treadonly approvalToken?: string;\n\t\t\treadonly arguments: unknown;\n\t\t\treadonly name: string;\n\t\t},\n\t\toptions?: {\n\t\t\treadonly resultGraceAfterAbortMs?: number;\n\t\t\treadonly signal?: AbortSignal;\n\t\t},\n\t) => Promise<{ readonly structuredContent?: unknown }>;\n\treadonly close: () => Promise<void>;\n\treadonly connect: () => Promise<void>;\n\treadonly readResource: (\n\t\trequest: PortalArtifactReadResourceRequest,\n\t\toptions?: {\n\t\t\treadonly resultGraceAfterAbortMs?: number;\n\t\t\treadonly signal?: AbortSignal;\n\t\t},\n\t) => Promise<{ readonly contents: readonly ToolPortalMcpResourceContent[] }>;\n}\n\nexport interface ToolPortalMcpClientOptions {\n\treadonly transport: ToolPortalMcpTransport;\n}\n\nexport interface ToolPortalClientRequestOptions {\n\treadonly approvalToken?: string;\n\treadonly resultGraceAfterAbortMs?: number;\n\treadonly signal?: AbortSignal;\n}\n\nconst canonicalBase64Pattern = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/u;\n\nfunction decodedBase64ByteLength(contentBase64: string): number {\n\tif (!canonicalBase64Pattern.test(contentBase64)) {\n\t\tthrow new TypeError('Tool Portal MCP artifact content is not canonical base64.');\n\t}\n\tconst paddingBytes = contentBase64.endsWith('==') ? 2 : contentBase64.endsWith('=') ? 1 : 0;\n\treturn (contentBase64.length / 4) * 3 - paddingBytes;\n}\n\nclass ToolPortalMcpArtifactOperations {\n\treadonly #transport: ToolPortalMcpTransport;\n\n\tconstructor(transport: ToolPortalMcpTransport) {\n\t\tthis.#transport = transport;\n\t}\n\n\tasync read(\n\t\trequest: PortalArtifactReadRequest,\n\t\toptions: ToolPortalClientRequestOptions = {},\n\t): Promise<PortalArtifactReadResult> {\n\t\tconst validatedRequest = PortalArtifactReadRequestSchema.parse(request);\n\t\tconst resourceRequest = createPortalArtifactReadResourceRequest(validatedRequest);\n\t\tconst response = await this.#transport.readResource(resourceRequest, options);\n\t\tconst content = response.contents.length === 1 ? response.contents[0] : undefined;\n\t\tif (\n\t\t\tcontent === undefined ||\n\t\t\tcontent.kind !== 'blob' ||\n\t\t\tcontent.uri !== resourceRequest.uri ||\n\t\t\tcontent.mediaType === undefined\n\t\t) {\n\t\t\tthrow new TypeError('Tool Portal MCP artifact read returned an invalid resource.');\n\t\t}\n\t\tconst returnedBytes = decodedBase64ByteLength(content.blob);\n\t\tif (returnedBytes > validatedRequest.maxBytes) {\n\t\t\tthrow new TypeError('Tool Portal MCP artifact read exceeded the requested byte range.');\n\t\t}\n\t\treturn PortalArtifactReadResultSchema.parse({\n\t\t\tcontentBase64: content.blob,\n\t\t\tmediaType: content.mediaType,\n\t\t\toffsetBytes: validatedRequest.offsetBytes,\n\t\t\treference: validatedRequest.reference,\n\t\t\ttruncated:\n\t\t\t\tvalidatedRequest.offsetBytes + returnedBytes < validatedRequest.reference.byteLength,\n\t\t});\n\t}\n}\n\n/**\n * Standard-MCP projection of the bounded Tool Portal surface.\n *\n * The transport is injected so this subpath remains independent from the\n * Gateway-runtime UDS client and its Node-specific dependencies.\n */\nexport class ToolPortalMcpClient {\n\treadonly #transport: ToolPortalMcpTransport;\n\treadonly artifacts: ToolPortalMcpArtifactOperations;\n\n\tconstructor(options: ToolPortalMcpClientOptions) {\n\t\tthis.#transport = options.transport;\n\t\tthis.artifacts = new ToolPortalMcpArtifactOperations(this.#transport);\n\t}\n\n\tasync connect(): Promise<void> {\n\t\tawait this.#transport.connect();\n\t}\n\n\tasync close(): Promise<void> {\n\t\tawait this.#transport.close();\n\t}\n\n\tasync list(\n\t\trequest: PortalListRequest,\n\t\toptions: ToolPortalClientRequestOptions = {},\n\t): Promise<PortalListResult> {\n\t\tconst validatedRequest = PortalListRequestSchema.parse(request);\n\t\tconst response = await this.#transport.callTool(\n\t\t\t{\n\t\t\t\targuments: validatedRequest,\n\t\t\t\tname: 'tool_portal_list',\n\t\t\t},\n\t\t\toptions,\n\t\t);\n\t\treturn PortalListResultSchema.parse(response.structuredContent);\n\t}\n\n\tasync search(\n\t\trequest: PortalSearchRequest,\n\t\toptions: ToolPortalClientRequestOptions = {},\n\t): Promise<PortalSearchResult> {\n\t\tconst validatedRequest = PortalSearchRequestSchema.parse(request);\n\t\tconst response = await this.#transport.callTool(\n\t\t\t{\n\t\t\t\targuments: validatedRequest,\n\t\t\t\tname: 'tool_portal_search',\n\t\t\t},\n\t\t\toptions,\n\t\t);\n\t\treturn PortalSearchResultSchema.parse(response.structuredContent);\n\t}\n\n\tasync describe(\n\t\trequest: PortalDescribeRequest,\n\t\toptions: ToolPortalClientRequestOptions = {},\n\t): Promise<PortalDescribeResult> {\n\t\tconst validatedRequest = PortalDescribeRequestSchema.parse(request);\n\t\tconst response = await this.#transport.callTool(\n\t\t\t{\n\t\t\t\targuments: validatedRequest,\n\t\t\t\tname: 'tool_portal_describe',\n\t\t\t},\n\t\t\toptions,\n\t\t);\n\t\treturn PortalDescribeResultSchema.parse(response.structuredContent);\n\t}\n\n\tasync call(\n\t\trequest: PortalCallRequest,\n\t\toptions: ToolPortalClientRequestOptions = {},\n\t): Promise<PortalCallResult> {\n\t\tconst validatedRequest = PortalCallRequestSchema.parse(request);\n\t\tconst response = await this.#transport.callTool(\n\t\t\t{\n\t\t\t\t...(options.approvalToken === undefined ? {} : { approvalToken: options.approvalToken }),\n\t\t\t\targuments: validatedRequest,\n\t\t\t\tname: 'tool_portal_call',\n\t\t\t},\n\t\t\toptions,\n\t\t);\n\t\treturn PortalCallResultSchema.parse(response.structuredContent);\n\t}\n}\n"],"mappings":";;;;;AA0EA,MAAM,yBAAyB;AAE/B,SAAS,wBAAwB,eAA+B;CAC/D,IAAI,CAAC,uBAAuB,KAAK,cAAc,EAC9C,MAAM,IAAI,UAAU,4DAA4D;CAEjF,MAAM,eAAe,cAAc,SAAS,KAAK,GAAG,IAAI,cAAc,SAAS,IAAI,GAAG,IAAI;CAC1F,OAAQ,cAAc,SAAS,IAAK,IAAI;;AAGzC,IAAM,kCAAN,MAAsC;CACrC;CAEA,YAAY,WAAmC;EAC9C,KAAKA,aAAa;;CAGnB,MAAM,KACL,SACA,UAA0C,EAAE,EACR;EACpC,MAAM,mBAAmB,gCAAgC,MAAM,QAAQ;EACvE,MAAM,kBAAkB,wCAAwC,iBAAiB;EACjF,MAAM,WAAW,MAAM,KAAKA,WAAW,aAAa,iBAAiB,QAAQ;EAC7E,MAAM,UAAU,SAAS,SAAS,WAAW,IAAI,SAAS,SAAS,KAAK,KAAA;EACxE,IACC,YAAY,KAAA,KACZ,QAAQ,SAAS,UACjB,QAAQ,QAAQ,gBAAgB,OAChC,QAAQ,cAAc,KAAA,GAEtB,MAAM,IAAI,UAAU,8DAA8D;EAEnF,MAAM,gBAAgB,wBAAwB,QAAQ,KAAK;EAC3D,IAAI,gBAAgB,iBAAiB,UACpC,MAAM,IAAI,UAAU,mEAAmE;EAExF,OAAO,+BAA+B,MAAM;GAC3C,eAAe,QAAQ;GACvB,WAAW,QAAQ;GACnB,aAAa,iBAAiB;GAC9B,WAAW,iBAAiB;GAC5B,WACC,iBAAiB,cAAc,gBAAgB,iBAAiB,UAAU;GAC3E,CAAC;;;;;;;;;AAUJ,IAAa,sBAAb,MAAiC;CAChC;CACA;CAEA,YAAY,SAAqC;EAChD,KAAKA,aAAa,QAAQ;EAC1B,KAAK,YAAY,IAAI,gCAAgC,KAAKA,WAAW;;CAGtE,MAAM,UAAyB;EAC9B,MAAM,KAAKA,WAAW,SAAS;;CAGhC,MAAM,QAAuB;EAC5B,MAAM,KAAKA,WAAW,OAAO;;CAG9B,MAAM,KACL,SACA,UAA0C,EAAE,EAChB;EAC5B,MAAM,mBAAmB,wBAAwB,MAAM,QAAQ;EAC/D,MAAM,WAAW,MAAM,KAAKA,WAAW,SACtC;GACC,WAAW;GACX,MAAM;GACN,EACD,QACA;EACD,OAAO,uBAAuB,MAAM,SAAS,kBAAkB;;CAGhE,MAAM,OACL,SACA,UAA0C,EAAE,EACd;EAC9B,MAAM,mBAAmB,0BAA0B,MAAM,QAAQ;EACjE,MAAM,WAAW,MAAM,KAAKA,WAAW,SACtC;GACC,WAAW;GACX,MAAM;GACN,EACD,QACA;EACD,OAAO,yBAAyB,MAAM,SAAS,kBAAkB;;CAGlE,MAAM,SACL,SACA,UAA0C,EAAE,EACZ;EAChC,MAAM,mBAAmB,4BAA4B,MAAM,QAAQ;EACnE,MAAM,WAAW,MAAM,KAAKA,WAAW,SACtC;GACC,WAAW;GACX,MAAM;GACN,EACD,QACA;EACD,OAAO,2BAA2B,MAAM,SAAS,kBAAkB;;CAGpE,MAAM,KACL,SACA,UAA0C,EAAE,EAChB;EAC5B,MAAM,mBAAmB,wBAAwB,MAAM,QAAQ;EAC/D,MAAM,WAAW,MAAM,KAAKA,WAAW,SACtC;GACC,GAAI,QAAQ,kBAAkB,KAAA,IAAY,EAAE,GAAG,EAAE,eAAe,QAAQ,eAAe;GACvF,WAAW;GACX,MAAM;GACN,EACD,QACA;EACD,OAAO,uBAAuB,MAAM,SAAS,kBAAkB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-vm/agent-portal-sdk",
-  "version": "0.0.113",
+  "version": "0.0.115",
   "description": "Portal-neutral Zod contracts and helpers for agent-facing capability surfaces.",
   "homepage": "https://github.com/ShravanSunder/agent-vm#readme",
   "bugs": {
@@ -13,8 +13,13 @@
     "url": "git+https://github.com/ShravanSunder/agent-vm.git",
     "directory": "packages/agent-portal-sdk"
   },
+  "bin": {
+    "tool-portal": "dist/cli/tool-portal.js"
+  },
   "files": [
-    "dist"
+    "contract-fixtures",
+    "dist",
+    "portable-contract-schema-manifest.json"
   ],
   "type": "module",
   "main": "./dist/index.js",
@@ -40,6 +45,18 @@
       "types": "./dist/capability-description-surface/index.d.ts",
       "import": "./dist/capability-description-surface/index.js"
     },
+    "./contracts": {
+      "types": "./dist/contracts/index.d.ts",
+      "import": "./dist/contracts/index.js"
+    },
+    "./gateway-runtime-client": {
+      "types": "./dist/gateway-runtime-client/index.d.ts",
+      "import": "./dist/gateway-runtime-client/index.js"
+    },
+    "./gateway-runtime-local-exec": {
+      "types": "./dist/gateway-runtime-local-exec/index.d.ts",
+      "import": "./dist/gateway-runtime-local-exec/index.js"
+    },
     "./portal-call-surface": {
       "types": "./dist/portal-call-surface/index.d.ts",
       "import": "./dist/portal-call-surface/index.js"
@@ -48,15 +65,28 @@
       "types": "./dist/portal-event-surface/index.d.ts",
       "import": "./dist/portal-event-surface/index.js"
     },
+    "./portable-contracts": {
+      "types": "./dist/portable-contracts/index.d.ts",
+      "import": "./dist/portable-contracts/index.js"
+    },
     "./testing": {
       "types": "./dist/testing/index.d.ts",
       "import": "./dist/testing/index.js"
+    },
+    "./tool-portal-mcp-client": {
+      "types": "./dist/tool-portal-mcp-client/index.d.ts",
+      "import": "./dist/tool-portal-mcp-client/index.js"
+    },
+    "./tool-portal-mcp-client/node-transport": {
+      "types": "./dist/tool-portal-mcp-client/node-tool-portal-mcp-transport.d.ts",
+      "import": "./dist/tool-portal-mcp-client/node-tool-portal-mcp-transport.js"
     }
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {