@akon-labs/nexus-cli 0.1.9 → 0.1.11-rc.2

package/dist/extensions/mcp/ui-stream-types.d.ts

@@ -0,0 +1,105 @@
+import { z } from "zod";
+export declare const UI_STREAM_HOST_CONTEXT_KEY = "nexus-mcp/stream";
+export declare const UI_STREAM_REQUEST_META_KEY = "nexus-mcp/stream-token";
+export declare const UI_STREAM_RESULT_PATCH_METHOD = "notifications/nexus-mcp/ui-result-patch";
+export declare const SERVER_STREAM_RESULT_PATCH_METHOD = "notifications/nexus-mcp/result-patch";
+export declare const UI_STREAM_STRUCTURED_CONTENT_KEY = "nexus-mcp/stream";
+export declare const uiStreamModeSchema: z.ZodEnum<{
+    eager: "eager";
+    "stream-first": "stream-first";
+}>;
+export type UiStreamMode = z.infer<typeof uiStreamModeSchema>;
+export declare const visualizationStreamPhaseSchema: z.ZodEnum<{
+    detail: "detail";
+    narrative: "narrative";
+    settled: "settled";
+    shell: "shell";
+    structure: "structure";
+}>;
+export type VisualizationStreamPhase = z.infer<typeof visualizationStreamPhaseSchema>;
+export declare const visualizationStreamFrameTypeSchema: z.ZodEnum<{
+    checkpoint: "checkpoint";
+    final: "final";
+    patch: "patch";
+}>;
+export type VisualizationStreamFrameType = z.infer<typeof visualizationStreamFrameTypeSchema>;
+export declare const visualizationStreamStatusSchema: z.ZodEnum<{
+    error: "error";
+    ok: "ok";
+}>;
+export type VisualizationStreamStatus = z.infer<typeof visualizationStreamStatusSchema>;
+export declare const uiStreamHostContextSchema: z.ZodObject<{
+    mode: z.ZodEnum<{
+        eager: "eager";
+        "stream-first": "stream-first";
+    }>;
+    streamId: z.ZodString;
+    intermediateResultPatches: z.ZodBoolean;
+    partialInput: z.ZodBoolean;
+}, z.core.$strip>;
+export type UiStreamHostContext = z.infer<typeof uiStreamHostContextSchema>;
+export declare const visualizationStreamEnvelopeSchema: z.ZodObject<{
+    streamId: z.ZodString;
+    sequence: z.ZodNumber;
+    frameType: z.ZodEnum<{
+        checkpoint: "checkpoint";
+        final: "final";
+        patch: "patch";
+    }>;
+    phase: z.ZodEnum<{
+        detail: "detail";
+        narrative: "narrative";
+        settled: "settled";
+        shell: "shell";
+        structure: "structure";
+    }>;
+    status: z.ZodEnum<{
+        error: "error";
+        ok: "ok";
+    }>;
+    message: z.ZodOptional<z.ZodString>;
+    spec: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    checkpoint: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type VisualizationStreamEnvelope = z.infer<typeof visualizationStreamEnvelopeSchema>;
+export declare const uiStreamCallToolResultSchema: z.ZodObject<{
+    content: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    isError: z.ZodOptional<z.ZodBoolean>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export type UiStreamCallToolResult = z.infer<typeof uiStreamCallToolResultSchema>;
+export declare const uiStreamResultPatchNotificationSchema: z.ZodObject<{
+    method: z.ZodLiteral<"notifications/nexus-mcp/ui-result-patch">;
+    params: z.ZodObject<{
+        content: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+        structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        isError: z.ZodOptional<z.ZodBoolean>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export type UiStreamResultPatchNotification = z.infer<typeof uiStreamResultPatchNotificationSchema>;
+export declare const serverStreamResultPatchNotificationSchema: z.ZodObject<{
+    method: z.ZodLiteral<"notifications/nexus-mcp/result-patch">;
+    params: z.ZodObject<{
+        streamToken: z.ZodString;
+        result: z.ZodObject<{
+            content: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+            structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            isError: z.ZodOptional<z.ZodBoolean>;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ServerStreamResultPatchNotification = z.infer<typeof serverStreamResultPatchNotificationSchema>;
+export interface UiStreamSummary {
+    streamId: string;
+    mode: UiStreamMode;
+    frames: number;
+    phases: VisualizationStreamPhase[];
+    finalStatus?: VisualizationStreamStatus;
+    lastMessage?: string;
+}
+export declare function getUiStreamHostContext(hostContext: Record<string, unknown> | undefined): UiStreamHostContext | undefined;
+export declare function getVisualizationStreamEnvelope(structuredContent: unknown): VisualizationStreamEnvelope | undefined;
+//# sourceMappingURL=ui-stream-types.d.ts.map

package/dist/extensions/mcp/ui-stream-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-stream-types.d.ts","sourceRoot":"","sources":["../../../src/extensions/mcp/ui-stream-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAC7D,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AACnE,eAAO,MAAM,6BAA6B,4CAA4C,CAAC;AACvF,eAAO,MAAM,iCAAiC,yCAAyC,CAAC;AACxF,eAAO,MAAM,gCAAgC,qBAAqB,CAAC;AAEnE,eAAO,MAAM,kBAAkB;;;EAAoC,CAAC;AACpE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,8BAA8B;;;;;;EAAmE,CAAC;AAC/G,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,kCAAkC;;;;EAA2C,CAAC;AAC3F,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,eAAO,MAAM,+BAA+B;;;EAA0B,CAAC;AACvE,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAKxF,eAAO,MAAM,yBAAyB;;;;;;;;iBAKpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;iBAS5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,eAAO,MAAM,4BAA4B;;;;;iBAO1B,CAAC;AAChB,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,qCAAqC;;;;;;;;iBAGhD,CAAC;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG,eAAO,MAAM,yCAAyC;;;;;;;;;;;iBAMpD,CAAC;AACH,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yCAAyC,CAAC,CAAC;AAE5G,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC,WAAW,CAAC,EAAE,yBAAyB,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,sBAAsB,CACrC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC9C,mBAAmB,GAAG,SAAS,CAIjC;AAED,wBAAgB,8BAA8B,CAAC,iBAAiB,EAAE,OAAO,GAAG,2BAA2B,GAAG,SAAS,CAOlH","sourcesContent":["import { z } from \"zod\";\n\nexport const UI_STREAM_HOST_CONTEXT_KEY = \"nexus-mcp/stream\";\nexport const UI_STREAM_REQUEST_META_KEY = \"nexus-mcp/stream-token\";\nexport const UI_STREAM_RESULT_PATCH_METHOD = \"notifications/nexus-mcp/ui-result-patch\";\nexport const SERVER_STREAM_RESULT_PATCH_METHOD = \"notifications/nexus-mcp/result-patch\";\nexport const UI_STREAM_STRUCTURED_CONTENT_KEY = \"nexus-mcp/stream\";\n\nexport const uiStreamModeSchema = z.enum([\"eager\", \"stream-first\"]);\nexport type UiStreamMode = z.infer<typeof uiStreamModeSchema>;\n\nexport const visualizationStreamPhaseSchema = z.enum([\"shell\", \"narrative\", \"structure\", \"detail\", \"settled\"]);\nexport type VisualizationStreamPhase = z.infer<typeof visualizationStreamPhaseSchema>;\n\nexport const visualizationStreamFrameTypeSchema = z.enum([\"patch\", \"checkpoint\", \"final\"]);\nexport type VisualizationStreamFrameType = z.infer<typeof visualizationStreamFrameTypeSchema>;\n\nexport const visualizationStreamStatusSchema = z.enum([\"ok\", \"error\"]);\nexport type VisualizationStreamStatus = z.infer<typeof visualizationStreamStatusSchema>;\n\nconst looseRecordSchema = z.record(z.string(), z.unknown());\nconst looseArraySchema = z.array(z.unknown());\n\nexport const uiStreamHostContextSchema = z.object({\n\tmode: uiStreamModeSchema,\n\tstreamId: z.string().min(1),\n\tintermediateResultPatches: z.boolean(),\n\tpartialInput: z.boolean(),\n});\nexport type UiStreamHostContext = z.infer<typeof uiStreamHostContextSchema>;\n\nexport const visualizationStreamEnvelopeSchema = z.object({\n\tstreamId: z.string().min(1),\n\tsequence: z.number().int().nonnegative(),\n\tframeType: visualizationStreamFrameTypeSchema,\n\tphase: visualizationStreamPhaseSchema,\n\tstatus: visualizationStreamStatusSchema,\n\tmessage: z.string().optional(),\n\tspec: looseRecordSchema.optional(),\n\tcheckpoint: looseRecordSchema.optional(),\n});\nexport type VisualizationStreamEnvelope = z.infer<typeof visualizationStreamEnvelopeSchema>;\n\nexport const uiStreamCallToolResultSchema = z\n\t.object({\n\t\tcontent: looseArraySchema.optional(),\n\t\tstructuredContent: looseRecordSchema.optional(),\n\t\tisError: z.boolean().optional(),\n\t\t_meta: looseRecordSchema.optional(),\n\t})\n\t.passthrough();\nexport type UiStreamCallToolResult = z.infer<typeof uiStreamCallToolResultSchema>;\n\nexport const uiStreamResultPatchNotificationSchema = z.object({\n\tmethod: z.literal(UI_STREAM_RESULT_PATCH_METHOD),\n\tparams: uiStreamCallToolResultSchema,\n});\nexport type UiStreamResultPatchNotification = z.infer<typeof uiStreamResultPatchNotificationSchema>;\n\nexport const serverStreamResultPatchNotificationSchema = z.object({\n\tmethod: z.literal(SERVER_STREAM_RESULT_PATCH_METHOD),\n\tparams: z.object({\n\t\tstreamToken: z.string().min(1),\n\t\tresult: uiStreamCallToolResultSchema,\n\t}),\n});\nexport type ServerStreamResultPatchNotification = z.infer<typeof serverStreamResultPatchNotificationSchema>;\n\nexport interface UiStreamSummary {\n\tstreamId: string;\n\tmode: UiStreamMode;\n\tframes: number;\n\tphases: VisualizationStreamPhase[];\n\tfinalStatus?: VisualizationStreamStatus;\n\tlastMessage?: string;\n}\n\nexport function getUiStreamHostContext(\n\thostContext: Record<string, unknown> | undefined,\n): UiStreamHostContext | undefined {\n\tconst candidate = hostContext?.[UI_STREAM_HOST_CONTEXT_KEY];\n\tconst parsed = uiStreamHostContextSchema.safeParse(candidate);\n\treturn parsed.success ? parsed.data : undefined;\n}\n\nexport function getVisualizationStreamEnvelope(structuredContent: unknown): VisualizationStreamEnvelope | undefined {\n\tif (!structuredContent || typeof structuredContent !== \"object\" || Array.isArray(structuredContent)) {\n\t\treturn undefined;\n\t}\n\tconst candidate = (structuredContent as Record<string, unknown>)[UI_STREAM_STRUCTURED_CONTENT_KEY];\n\tconst parsed = visualizationStreamEnvelopeSchema.safeParse(candidate);\n\treturn parsed.success ? parsed.data : undefined;\n}\n"]}

package/dist/extensions/mcp/ui-stream-types.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+export const UI_STREAM_HOST_CONTEXT_KEY = "nexus-mcp/stream";
+export const UI_STREAM_REQUEST_META_KEY = "nexus-mcp/stream-token";
+export const UI_STREAM_RESULT_PATCH_METHOD = "notifications/nexus-mcp/ui-result-patch";
+export const SERVER_STREAM_RESULT_PATCH_METHOD = "notifications/nexus-mcp/result-patch";
+export const UI_STREAM_STRUCTURED_CONTENT_KEY = "nexus-mcp/stream";
+export const uiStreamModeSchema = z.enum(["eager", "stream-first"]);
+export const visualizationStreamPhaseSchema = z.enum(["shell", "narrative", "structure", "detail", "settled"]);
+export const visualizationStreamFrameTypeSchema = z.enum(["patch", "checkpoint", "final"]);
+export const visualizationStreamStatusSchema = z.enum(["ok", "error"]);
+const looseRecordSchema = z.record(z.string(), z.unknown());
+const looseArraySchema = z.array(z.unknown());
+export const uiStreamHostContextSchema = z.object({
+    mode: uiStreamModeSchema,
+    streamId: z.string().min(1),
+    intermediateResultPatches: z.boolean(),
+    partialInput: z.boolean(),
+});
+export const visualizationStreamEnvelopeSchema = z.object({
+    streamId: z.string().min(1),
+    sequence: z.number().int().nonnegative(),
+    frameType: visualizationStreamFrameTypeSchema,
+    phase: visualizationStreamPhaseSchema,
+    status: visualizationStreamStatusSchema,
+    message: z.string().optional(),
+    spec: looseRecordSchema.optional(),
+    checkpoint: looseRecordSchema.optional(),
+});
+export const uiStreamCallToolResultSchema = z
+    .object({
+    content: looseArraySchema.optional(),
+    structuredContent: looseRecordSchema.optional(),
+    isError: z.boolean().optional(),
+    _meta: looseRecordSchema.optional(),
+})
+    .passthrough();
+export const uiStreamResultPatchNotificationSchema = z.object({
+    method: z.literal(UI_STREAM_RESULT_PATCH_METHOD),
+    params: uiStreamCallToolResultSchema,
+});
+export const serverStreamResultPatchNotificationSchema = z.object({
+    method: z.literal(SERVER_STREAM_RESULT_PATCH_METHOD),
+    params: z.object({
+        streamToken: z.string().min(1),
+        result: uiStreamCallToolResultSchema,
+    }),
+});
+export function getUiStreamHostContext(hostContext) {
+    const candidate = hostContext?.[UI_STREAM_HOST_CONTEXT_KEY];
+    const parsed = uiStreamHostContextSchema.safeParse(candidate);
+    return parsed.success ? parsed.data : undefined;
+}
+export function getVisualizationStreamEnvelope(structuredContent) {
+    if (!structuredContent || typeof structuredContent !== "object" || Array.isArray(structuredContent)) {
+        return undefined;
+    }
+    const candidate = structuredContent[UI_STREAM_STRUCTURED_CONTENT_KEY];
+    const parsed = visualizationStreamEnvelopeSchema.safeParse(candidate);
+    return parsed.success ? parsed.data : undefined;
+}
+//# sourceMappingURL=ui-stream-types.js.map

package/dist/extensions/mcp/ui-stream-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-stream-types.js","sourceRoot":"","sources":["../../../src/extensions/mcp/ui-stream-types.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nexport const UI_STREAM_HOST_CONTEXT_KEY = \"nexus-mcp/stream\";\nexport const UI_STREAM_REQUEST_META_KEY = \"nexus-mcp/stream-token\";\nexport const UI_STREAM_RESULT_PATCH_METHOD = \"notifications/nexus-mcp/ui-result-patch\";\nexport const SERVER_STREAM_RESULT_PATCH_METHOD = \"notifications/nexus-mcp/result-patch\";\nexport const UI_STREAM_STRUCTURED_CONTENT_KEY = \"nexus-mcp/stream\";\n\nexport const uiStreamModeSchema = z.enum([\"eager\", \"stream-first\"]);\nexport type UiStreamMode = z.infer<typeof uiStreamModeSchema>;\n\nexport const visualizationStreamPhaseSchema = z.enum([\"shell\", \"narrative\", \"structure\", \"detail\", \"settled\"]);\nexport type VisualizationStreamPhase = z.infer<typeof visualizationStreamPhaseSchema>;\n\nexport const visualizationStreamFrameTypeSchema = z.enum([\"patch\", \"checkpoint\", \"final\"]);\nexport type VisualizationStreamFrameType = z.infer<typeof visualizationStreamFrameTypeSchema>;\n\nexport const visualizationStreamStatusSchema = z.enum([\"ok\", \"error\"]);\nexport type VisualizationStreamStatus = z.infer<typeof visualizationStreamStatusSchema>;\n\nconst looseRecordSchema = z.record(z.string(), z.unknown());\nconst looseArraySchema = z.array(z.unknown());\n\nexport const uiStreamHostContextSchema = z.object({\n\tmode: uiStreamModeSchema,\n\tstreamId: z.string().min(1),\n\tintermediateResultPatches: z.boolean(),\n\tpartialInput: z.boolean(),\n});\nexport type UiStreamHostContext = z.infer<typeof uiStreamHostContextSchema>;\n\nexport const visualizationStreamEnvelopeSchema = z.object({\n\tstreamId: z.string().min(1),\n\tsequence: z.number().int().nonnegative(),\n\tframeType: visualizationStreamFrameTypeSchema,\n\tphase: visualizationStreamPhaseSchema,\n\tstatus: visualizationStreamStatusSchema,\n\tmessage: z.string().optional(),\n\tspec: looseRecordSchema.optional(),\n\tcheckpoint: looseRecordSchema.optional(),\n});\nexport type VisualizationStreamEnvelope = z.infer<typeof visualizationStreamEnvelopeSchema>;\n\nexport const uiStreamCallToolResultSchema = z\n\t.object({\n\t\tcontent: looseArraySchema.optional(),\n\t\tstructuredContent: looseRecordSchema.optional(),\n\t\tisError: z.boolean().optional(),\n\t\t_meta: looseRecordSchema.optional(),\n\t})\n\t.passthrough();\nexport type UiStreamCallToolResult = z.infer<typeof uiStreamCallToolResultSchema>;\n\nexport const uiStreamResultPatchNotificationSchema = z.object({\n\tmethod: z.literal(UI_STREAM_RESULT_PATCH_METHOD),\n\tparams: uiStreamCallToolResultSchema,\n});\nexport type UiStreamResultPatchNotification = z.infer<typeof uiStreamResultPatchNotificationSchema>;\n\nexport const serverStreamResultPatchNotificationSchema = z.object({\n\tmethod: z.literal(SERVER_STREAM_RESULT_PATCH_METHOD),\n\tparams: z.object({\n\t\tstreamToken: z.string().min(1),\n\t\tresult: uiStreamCallToolResultSchema,\n\t}),\n});\nexport type ServerStreamResultPatchNotification = z.infer<typeof serverStreamResultPatchNotificationSchema>;\n\nexport interface UiStreamSummary {\n\tstreamId: string;\n\tmode: UiStreamMode;\n\tframes: number;\n\tphases: VisualizationStreamPhase[];\n\tfinalStatus?: VisualizationStreamStatus;\n\tlastMessage?: string;\n}\n\nexport function getUiStreamHostContext(\n\thostContext: Record<string, unknown> | undefined,\n): UiStreamHostContext | undefined {\n\tconst candidate = hostContext?.[UI_STREAM_HOST_CONTEXT_KEY];\n\tconst parsed = uiStreamHostContextSchema.safeParse(candidate);\n\treturn parsed.success ? parsed.data : undefined;\n}\n\nexport function getVisualizationStreamEnvelope(structuredContent: unknown): VisualizationStreamEnvelope | undefined {\n\tif (!structuredContent || typeof structuredContent !== \"object\" || Array.isArray(structuredContent)) {\n\t\treturn undefined;\n\t}\n\tconst candidate = (structuredContent as Record<string, unknown>)[UI_STREAM_STRUCTURED_CONTENT_KEY];\n\tconst parsed = visualizationStreamEnvelopeSchema.safeParse(candidate);\n\treturn parsed.success ? parsed.data : undefined;\n}\n"]}

package/dist/extensions/mcp/ui-tool-visibility.d.ts

@@ -0,0 +1,5 @@
+export type UiToolVisibility = "model" | "app";
+export declare function extractUiToolVisibility(meta: Record<string, unknown> | undefined): UiToolVisibility[] | undefined;
+export declare function isUiToolVisibleToModel(visibility: readonly UiToolVisibility[] | undefined): boolean;
+export declare function isUiToolCallableByApp(visibility: readonly UiToolVisibility[] | undefined): boolean;
+//# sourceMappingURL=ui-tool-visibility.d.ts.map

package/dist/extensions/mcp/ui-tool-visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-tool-visibility.d.ts","sourceRoot":"","sources":["../../../src/extensions/mcp/ui-tool-visibility.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,KAAK,CAAC;AAE/C,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,gBAAgB,EAAE,GAAG,SAAS,CAcjH;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,GAAG,OAAO,CAEnG;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,GAAG,OAAO,CAElG","sourcesContent":["export type UiToolVisibility = \"model\" | \"app\";\n\nexport function extractUiToolVisibility(meta: Record<string, unknown> | undefined): UiToolVisibility[] | undefined {\n\tif (!meta || typeof meta !== \"object\") return undefined;\n\tconst ui = meta.ui;\n\tif (!ui || typeof ui !== \"object\" || Array.isArray(ui)) return undefined;\n\tconst visibility = (ui as Record<string, unknown>).visibility;\n\tif (visibility === undefined) return undefined;\n\tif (!Array.isArray(visibility)) return [];\n\n\tconst values: UiToolVisibility[] = [];\n\tfor (const entry of visibility) {\n\t\tif (entry !== \"model\" && entry !== \"app\") return [];\n\t\tif (!values.includes(entry)) values.push(entry);\n\t}\n\treturn values;\n}\n\nexport function isUiToolVisibleToModel(visibility: readonly UiToolVisibility[] | undefined): boolean {\n\treturn visibility === undefined || visibility.includes(\"model\");\n}\n\nexport function isUiToolCallableByApp(visibility: readonly UiToolVisibility[] | undefined): boolean {\n\treturn visibility === undefined || visibility.includes(\"app\");\n}\n"]}

package/dist/extensions/mcp/ui-tool-visibility.js

@@ -0,0 +1,27 @@
+export function extractUiToolVisibility(meta) {
+    if (!meta || typeof meta !== "object")
+        return undefined;
+    const ui = meta.ui;
+    if (!ui || typeof ui !== "object" || Array.isArray(ui))
+        return undefined;
+    const visibility = ui.visibility;
+    if (visibility === undefined)
+        return undefined;
+    if (!Array.isArray(visibility))
+        return [];
+    const values = [];
+    for (const entry of visibility) {
+        if (entry !== "model" && entry !== "app")
+            return [];
+        if (!values.includes(entry))
+            values.push(entry);
+    }
+    return values;
+}
+export function isUiToolVisibleToModel(visibility) {
+    return visibility === undefined || visibility.includes("model");
+}
+export function isUiToolCallableByApp(visibility) {
+    return visibility === undefined || visibility.includes("app");
+}
+//# sourceMappingURL=ui-tool-visibility.js.map

package/dist/extensions/mcp/ui-tool-visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-tool-visibility.js","sourceRoot":"","sources":["../../../src/extensions/mcp/ui-tool-visibility.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,uBAAuB,CAAC,IAAyC,EAAkC;IAClH,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACxD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IACzE,MAAM,UAAU,GAAI,EAA8B,CAAC,UAAU,CAAC;IAC9D,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IAE1C,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,KAAK;YAAE,OAAO,EAAE,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC;AAAA,CACd;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAmD,EAAW;IACpG,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAAA,CAChE;AAED,MAAM,UAAU,qBAAqB,CAAC,UAAmD,EAAW;IACnG,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAAA,CAC9D","sourcesContent":["export type UiToolVisibility = \"model\" | \"app\";\n\nexport function extractUiToolVisibility(meta: Record<string, unknown> | undefined): UiToolVisibility[] | undefined {\n\tif (!meta || typeof meta !== \"object\") return undefined;\n\tconst ui = meta.ui;\n\tif (!ui || typeof ui !== \"object\" || Array.isArray(ui)) return undefined;\n\tconst visibility = (ui as Record<string, unknown>).visibility;\n\tif (visibility === undefined) return undefined;\n\tif (!Array.isArray(visibility)) return [];\n\n\tconst values: UiToolVisibility[] = [];\n\tfor (const entry of visibility) {\n\t\tif (entry !== \"model\" && entry !== \"app\") return [];\n\t\tif (!values.includes(entry)) values.push(entry);\n\t}\n\treturn values;\n}\n\nexport function isUiToolVisibleToModel(visibility: readonly UiToolVisibility[] | undefined): boolean {\n\treturn visibility === undefined || visibility.includes(\"model\");\n}\n\nexport function isUiToolCallableByApp(visibility: readonly UiToolVisibility[] | undefined): boolean {\n\treturn visibility === undefined || visibility.includes(\"app\");\n}\n"]}

package/dist/extensions/mcp/unix-socket-transport.d.ts

@@ -0,0 +1,15 @@
+import type { JSONRPCMessage, Transport } from "@modelcontextprotocol/client";
+/** MCP JSONL transport for an explicitly configured Unix-domain socket. */
+export declare class UnixSocketClientTransport implements Transport {
+    private socket;
+    private readonly readBuffer;
+    onclose?: () => void;
+    onerror?: (error: Error) => void;
+    onmessage?: (message: JSONRPCMessage) => void;
+    private readonly socketPath;
+    constructor(socketPath: string);
+    start(): Promise<void>;
+    close(): Promise<void>;
+    send(message: JSONRPCMessage): Promise<void>;
+}
+//# sourceMappingURL=unix-socket-transport.d.ts.map

package/dist/extensions/mcp/unix-socket-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix-socket-transport.d.ts","sourceRoot":"","sources":["../../../src/extensions/mcp/unix-socket-transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAG9E,2EAA2E;AAC3E,qBAAa,yBAA0B,YAAW,SAAS;IAC1D,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAE/C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,YAAY,UAAU,EAAE,MAAM,EAE7B;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAsC3B;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAe3B;IAEK,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAUjD;CACD","sourcesContent":["import { createConnection, type Socket } from \"node:net\";\nimport type { JSONRPCMessage, Transport } from \"@modelcontextprotocol/client\";\nimport { ReadBuffer, serializeMessage } from \"@modelcontextprotocol/client\";\n\n/** MCP JSONL transport for an explicitly configured Unix-domain socket. */\nexport class UnixSocketClientTransport implements Transport {\n\tprivate socket: Socket | undefined;\n\tprivate readonly readBuffer = new ReadBuffer();\n\n\tonclose?: () => void;\n\tonerror?: (error: Error) => void;\n\tonmessage?: (message: JSONRPCMessage) => void;\n\tprivate readonly socketPath: string;\n\n\tconstructor(socketPath: string) {\n\t\tthis.socketPath = socketPath;\n\t}\n\n\tasync start(): Promise<void> {\n\t\tif (this.socket) {\n\t\t\tthrow new Error(\"UnixSocketClientTransport already started\");\n\t\t}\n\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tconst socket = createConnection(this.socketPath);\n\t\t\tthis.socket = socket;\n\t\t\tlet connected = false;\n\n\t\t\tsocket.once(\"connect\", () => {\n\t\t\t\tconnected = true;\n\t\t\t\tresolve();\n\t\t\t});\n\t\t\tsocket.on(\"data\", (chunk) => {\n\t\t\t\ttry {\n\t\t\t\t\tthis.readBuffer.append(chunk);\n\t\t\t\t\twhile (true) {\n\t\t\t\t\t\tconst message = this.readBuffer.readMessage();\n\t\t\t\t\t\tif (message === null) break;\n\t\t\t\t\t\tthis.onmessage?.(message);\n\t\t\t\t\t}\n\t\t\t\t} catch (error) {\n\t\t\t\t\tconst cause = error instanceof Error ? error : new Error(String(error));\n\t\t\t\t\tthis.onerror?.(cause);\n\t\t\t\t\tvoid this.close();\n\t\t\t\t}\n\t\t\t});\n\t\t\tsocket.on(\"error\", (error) => {\n\t\t\t\tif (!connected) reject(error);\n\t\t\t\tthis.onerror?.(error);\n\t\t\t});\n\t\t\tsocket.on(\"close\", () => {\n\t\t\t\tif (this.socket === socket) this.socket = undefined;\n\t\t\t\tthis.readBuffer.clear();\n\t\t\t\tthis.onclose?.();\n\t\t\t});\n\t\t});\n\t}\n\n\tasync close(): Promise<void> {\n\t\tconst socket = this.socket;\n\t\tthis.socket = undefined;\n\t\tthis.readBuffer.clear();\n\t\tif (!socket || socket.destroyed) return;\n\n\t\tawait new Promise<void>((resolve) => {\n\t\t\tconst timeout = setTimeout(() => socket.destroy(), 2_000);\n\t\t\ttimeout.unref();\n\t\t\tsocket.once(\"close\", () => {\n\t\t\t\tclearTimeout(timeout);\n\t\t\t\tresolve();\n\t\t\t});\n\t\t\tsocket.end();\n\t\t});\n\t}\n\n\tasync send(message: JSONRPCMessage): Promise<void> {\n\t\tconst socket = this.socket;\n\t\tif (!socket || socket.destroyed) throw new Error(\"Unix socket is not connected\");\n\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tsocket.write(serializeMessage(message), (error) => {\n\t\t\t\tif (error) reject(error);\n\t\t\t\telse resolve();\n\t\t\t});\n\t\t});\n\t}\n}\n"]}

package/dist/extensions/mcp/unix-socket-transport.js

@@ -0,0 +1,85 @@
+import { createConnection } from "node:net";
+import { ReadBuffer, serializeMessage } from "@modelcontextprotocol/client";
+/** MCP JSONL transport for an explicitly configured Unix-domain socket. */
+export class UnixSocketClientTransport {
+    socket;
+    readBuffer = new ReadBuffer();
+    onclose;
+    onerror;
+    onmessage;
+    socketPath;
+    constructor(socketPath) {
+        this.socketPath = socketPath;
+    }
+    async start() {
+        if (this.socket) {
+            throw new Error("UnixSocketClientTransport already started");
+        }
+        await new Promise((resolve, reject) => {
+            const socket = createConnection(this.socketPath);
+            this.socket = socket;
+            let connected = false;
+            socket.once("connect", () => {
+                connected = true;
+                resolve();
+            });
+            socket.on("data", (chunk) => {
+                try {
+                    this.readBuffer.append(chunk);
+                    while (true) {
+                        const message = this.readBuffer.readMessage();
+                        if (message === null)
+                            break;
+                        this.onmessage?.(message);
+                    }
+                }
+                catch (error) {
+                    const cause = error instanceof Error ? error : new Error(String(error));
+                    this.onerror?.(cause);
+                    void this.close();
+                }
+            });
+            socket.on("error", (error) => {
+                if (!connected)
+                    reject(error);
+                this.onerror?.(error);
+            });
+            socket.on("close", () => {
+                if (this.socket === socket)
+                    this.socket = undefined;
+                this.readBuffer.clear();
+                this.onclose?.();
+            });
+        });
+    }
+    async close() {
+        const socket = this.socket;
+        this.socket = undefined;
+        this.readBuffer.clear();
+        if (!socket || socket.destroyed)
+            return;
+        await new Promise((resolve) => {
+            const timeout = setTimeout(() => socket.destroy(), 2_000);
+            timeout.unref();
+            socket.once("close", () => {
+                clearTimeout(timeout);
+                resolve();
+            });
+            socket.end();
+        });
+    }
+    async send(message) {
+        const socket = this.socket;
+        if (!socket || socket.destroyed)
+            throw new Error("Unix socket is not connected");
+        await new Promise((resolve, reject) => {
+            socket.write(serializeMessage(message), (error) => {
+                if (error)
+                    reject(error);
+                else
+                    resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=unix-socket-transport.js.map

package/dist/extensions/mcp/unix-socket-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix-socket-transport.js","sourceRoot":"","sources":["../../../src/extensions/mcp/unix-socket-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAe,MAAM,UAAU,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAE5E,2EAA2E;AAC3E,MAAM,OAAO,yBAAyB;IAC7B,MAAM,CAAqB;IAClB,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IAE/C,OAAO,CAAc;IACrB,OAAO,CAA0B;IACjC,SAAS,CAAqC;IAC7B,UAAU,CAAS;IAEpC,YAAY,UAAkB,EAAE;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAAA,CAC7B;IAED,KAAK,CAAC,KAAK,GAAkB;QAC5B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,IAAI,SAAS,GAAG,KAAK,CAAC;YAEtB,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC;gBAC5B,SAAS,GAAG,IAAI,CAAC;gBACjB,OAAO,EAAE,CAAC;YAAA,CACV,CAAC,CAAC;YACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACJ,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC9B,OAAO,IAAI,EAAE,CAAC;wBACb,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;wBAC9C,IAAI,OAAO,KAAK,IAAI;4BAAE,MAAM;wBAC5B,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;oBAC3B,CAAC;gBACF,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAChB,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBACxE,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;oBACtB,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;gBACnB,CAAC;YAAA,CACD,CAAC,CAAC;YACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;gBAC7B,IAAI,CAAC,SAAS;oBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC9B,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;YAAA,CACtB,CAAC,CAAC;YACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC;gBACxB,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;oBAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;gBACpD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBACxB,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YAAA,CACjB,CAAC,CAAC;QAAA,CACH,CAAC,CAAC;IAAA,CACH;IAED,KAAK,CAAC,KAAK,GAAkB;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS;YAAE,OAAO;QAExC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;YAC1D,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC;gBAC1B,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,OAAO,EAAE,CAAC;YAAA,CACV,CAAC,CAAC;YACH,MAAM,CAAC,GAAG,EAAE,CAAC;QAAA,CACb,CAAC,CAAC;IAAA,CACH;IAED,KAAK,CAAC,IAAI,CAAC,OAAuB,EAAiB;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAEjF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;YAC5C,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;gBAClD,IAAI,KAAK;oBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;;oBACpB,OAAO,EAAE,CAAC;YAAA,CACf,CAAC,CAAC;QAAA,CACH,CAAC,CAAC;IAAA,CACH;CACD","sourcesContent":["import { createConnection, type Socket } from \"node:net\";\nimport type { JSONRPCMessage, Transport } from \"@modelcontextprotocol/client\";\nimport { ReadBuffer, serializeMessage } from \"@modelcontextprotocol/client\";\n\n/** MCP JSONL transport for an explicitly configured Unix-domain socket. */\nexport class UnixSocketClientTransport implements Transport {\n\tprivate socket: Socket | undefined;\n\tprivate readonly readBuffer = new ReadBuffer();\n\n\tonclose?: () => void;\n\tonerror?: (error: Error) => void;\n\tonmessage?: (message: JSONRPCMessage) => void;\n\tprivate readonly socketPath: string;\n\n\tconstructor(socketPath: string) {\n\t\tthis.socketPath = socketPath;\n\t}\n\n\tasync start(): Promise<void> {\n\t\tif (this.socket) {\n\t\t\tthrow new Error(\"UnixSocketClientTransport already started\");\n\t\t}\n\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tconst socket = createConnection(this.socketPath);\n\t\t\tthis.socket = socket;\n\t\t\tlet connected = false;\n\n\t\t\tsocket.once(\"connect\", () => {\n\t\t\t\tconnected = true;\n\t\t\t\tresolve();\n\t\t\t});\n\t\t\tsocket.on(\"data\", (chunk) => {\n\t\t\t\ttry {\n\t\t\t\t\tthis.readBuffer.append(chunk);\n\t\t\t\t\twhile (true) {\n\t\t\t\t\t\tconst message = this.readBuffer.readMessage();\n\t\t\t\t\t\tif (message === null) break;\n\t\t\t\t\t\tthis.onmessage?.(message);\n\t\t\t\t\t}\n\t\t\t\t} catch (error) {\n\t\t\t\t\tconst cause = error instanceof Error ? error : new Error(String(error));\n\t\t\t\t\tthis.onerror?.(cause);\n\t\t\t\t\tvoid this.close();\n\t\t\t\t}\n\t\t\t});\n\t\t\tsocket.on(\"error\", (error) => {\n\t\t\t\tif (!connected) reject(error);\n\t\t\t\tthis.onerror?.(error);\n\t\t\t});\n\t\t\tsocket.on(\"close\", () => {\n\t\t\t\tif (this.socket === socket) this.socket = undefined;\n\t\t\t\tthis.readBuffer.clear();\n\t\t\t\tthis.onclose?.();\n\t\t\t});\n\t\t});\n\t}\n\n\tasync close(): Promise<void> {\n\t\tconst socket = this.socket;\n\t\tthis.socket = undefined;\n\t\tthis.readBuffer.clear();\n\t\tif (!socket || socket.destroyed) return;\n\n\t\tawait new Promise<void>((resolve) => {\n\t\t\tconst timeout = setTimeout(() => socket.destroy(), 2_000);\n\t\t\ttimeout.unref();\n\t\t\tsocket.once(\"close\", () => {\n\t\t\t\tclearTimeout(timeout);\n\t\t\t\tresolve();\n\t\t\t});\n\t\t\tsocket.end();\n\t\t});\n\t}\n\n\tasync send(message: JSONRPCMessage): Promise<void> {\n\t\tconst socket = this.socket;\n\t\tif (!socket || socket.destroyed) throw new Error(\"Unix socket is not connected\");\n\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tsocket.write(serializeMessage(message), (error) => {\n\t\t\t\tif (error) reject(error);\n\t\t\t\telse resolve();\n\t\t\t});\n\t\t});\n\t}\n}\n"]}

package/dist/extensions/mcp/utils.d.ts

@@ -0,0 +1,32 @@
+import type { ExtensionAPI } from "../../core/extensions/types.ts";
+import type { McpConfig, ServerEntry } from "./types.ts";
+export declare function openUrl(nexus: ExtensionAPI, url: string, browser?: string, signal?: AbortSignal): Promise<void>;
+export declare function openPath(nexus: ExtensionAPI, targetPath: string): Promise<void>;
+export declare function parallelLimit<T, R>(items: T[], limit: number, fn: (item: T) => Promise<R>): Promise<R[]>;
+export declare function getConfigPathFromArgv(): string | undefined;
+export declare function interpolateEnvVars(value: string): string;
+export declare function toStringRecord(value: unknown): Record<string, string> | undefined;
+export declare function interpolateEnvRecord(values: Record<string, string> | undefined): Record<string, string> | undefined;
+/** Resolve a secret value, executing only a single leading `!` command marker. */
+export declare function resolveCommandSecret(value: string, context: string): string;
+export declare function resolveCommandSecret(value: undefined, context: string): undefined;
+export declare function resolveCommandSecret(value: string | undefined, context: string): string | undefined;
+/** Resolve command markers in a configured record without mutating the input. */
+export declare function resolveCommandSecretsRecord(values: Record<string, string> | undefined, context: (key: string) => string): Record<string, string> | undefined;
+export declare function resolveServerUrl(definition: Pick<ServerEntry, "url">): string | undefined;
+export declare function resolveConfigPath(value: string | undefined): string | undefined;
+export declare function resolveBearerToken(definition: Pick<ServerEntry, "bearerToken" | "bearerTokenEnv">): string | undefined;
+/** Remove OSC control strings, including payloads that have no terminator. */
+export declare function stripOscSequences(text: string): string;
+export declare function sanitizeTerminalText(text: string): string;
+export declare function formatTerminalError(error: unknown): string;
+export declare function truncateAtWord(text: string, target: number): string;
+export declare function normalizeDirectToolInputSchema(schema: unknown): Record<string, unknown>;
+export declare function normalizeToolArguments(value: unknown, context?: string): Record<string, unknown>;
+export declare function formatAuthRequiredMessage(config: Pick<McpConfig, "settings">, serverName: string, defaultMessage: string): string;
+export declare function formatMcpStatus(config: Pick<McpConfig, "settings">, message: string): string | undefined;
+/**
+ * Extract the adapter-owned UI stream mode from tool metadata.
+ */
+export declare function extractToolUiStreamMode(toolMeta: Record<string, unknown> | undefined): "eager" | "stream-first" | undefined;
+//# sourceMappingURL=utils.d.ts.map

package/dist/extensions/mcp/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/extensions/mcp/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport { homedir, platform } from \"node:os\";\nimport { extname, isAbsolute, join } from \"node:path\";\nimport type { ExtensionAPI } from \"../../core/extensions/types.ts\";\nimport type { McpConfig, ServerEntry } from \"./types.ts\";\n\nasync function execOpen(nexus: ExtensionAPI, target: string, browser?: string, signal?: AbortSignal) {\n\tconst os = platform();\n\n\tif (os === \"darwin\") {\n\t\tif (browser) {\n\t\t\t// An absolute executable path (e.g. from $BROWSER) names a launcher\n\t\t\t// binary. App bundles still go through `open -a`, which handles them.\n\t\t\treturn isAbsolute(browser) && extname(browser).toLowerCase() !== \".app\"\n\t\t\t\t? nexus.exec(browser, [target], signal ? { signal } : {})\n\t\t\t\t: nexus.exec(\"open\", [\"-a\", browser, target], signal ? { signal } : {});\n\t\t}\n\t\treturn nexus.exec(\"open\", [target], signal ? { signal } : {});\n\t}\n\tif (os === \"win32\") {\n\t\treturn browser\n\t\t\t? nexus.exec(\"cmd\", [\"/c\", \"start\", \"\", browser, target], signal ? { signal } : {})\n\t\t\t: nexus.exec(\"cmd\", [\"/c\", \"start\", \"\", target], signal ? { signal } : {});\n\t}\n\treturn browser\n\t\t? nexus.exec(browser, [target], signal ? { signal } : {})\n\t\t: nexus.exec(\"xdg-open\", [target], signal ? { signal } : {});\n}\n\nexport async function openUrl(nexus: ExtensionAPI, url: string, browser?: string, signal?: AbortSignal): Promise<void> {\n\tconst result = await execOpen(nexus, url, browser, signal);\n\tif (result.code !== 0) {\n\t\tthrow new Error(result.stderr || `Failed to open browser (exit code ${result.code})`);\n\t}\n}\n\nexport async function openPath(nexus: ExtensionAPI, targetPath: string): Promise<void> {\n\tconst result = await execOpen(nexus, targetPath);\n\tif (result.code !== 0) {\n\t\tthrow new Error(result.stderr || `Failed to open path (exit code ${result.code})`);\n\t}\n}\n\nexport async function parallelLimit<T, R>(items: T[], limit: number, fn: (item: T) => Promise<R>): Promise<R[]> {\n\tconst results: R[] = [];\n\tconst iterator = items.entries();\n\n\tasync function worker() {\n\t\twhile (true) {\n\t\t\tconst next = iterator.next();\n\t\t\tif (next.done) return;\n\t\t\tconst [index, item] = next.value;\n\t\t\tresults[index] = await fn(item);\n\t\t}\n\t}\n\n\tconst workers = Array(Math.min(limit, items.length))\n\t\t.fill(null)\n\t\t.map(() => worker());\n\tawait Promise.all(workers);\n\treturn results;\n}\n\nexport function getConfigPathFromArgv(): string | undefined {\n\tconst idx = process.argv.indexOf(\"--mcp-config\");\n\tif (idx >= 0 && idx + 1 < process.argv.length) {\n\t\treturn process.argv[idx + 1];\n\t}\n\treturn undefined;\n}\n\nexport function interpolateEnvVars(value: string): string {\n\treturn value\n\t\t.replace(/\\$\\{(\\w+)\\}/g, (_, name) => process.env[name] ?? \"\")\n\t\t.replace(/\\$env:(\\w+)/g, (_, name) => process.env[name] ?? \"\")\n\t\t.replace(/\\{env:(\\w+)\\}/g, (_, name) => process.env[name] ?? \"\");\n}\n\nfunction getMissingEnvVars(value: string): string[] {\n\tconst missing = new Set<string>();\n\tfor (const match of value.matchAll(/\\$\\{(\\w+)\\}|\\$env:(\\w+)|\\{env:(\\w+)\\}/g)) {\n\t\tconst name = match[1] ?? match[2] ?? match[3];\n\t\tif (name && process.env[name] === undefined) {\n\t\t\tmissing.add(name);\n\t\t}\n\t}\n\treturn [...missing];\n}\n\nexport function toStringRecord(value: unknown): Record<string, string> | undefined {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n\n\tconst result: Record<string, string> = {};\n\tfor (const [key, entry] of Object.entries(value)) {\n\t\tif (typeof entry === \"string\") result[key] = entry;\n\t}\n\treturn Object.keys(result).length > 0 ? result : undefined;\n}\n\nfunction interpolateSecretExpression(value: string): string {\n\tif (value.startsWith(\"!!\")) return interpolateEnvVars(value.slice(1));\n\treturn value.startsWith(\"!\") ? value : interpolateEnvVars(value);\n}\n\nexport function interpolateEnvRecord(values: Record<string, string> | undefined): Record<string, string> | undefined {\n\tif (!values) return undefined;\n\n\treturn Object.fromEntries(Object.entries(values).map(([key, value]) => [key, interpolateSecretExpression(value)]));\n}\n\nconst COMMAND_SECRET_TIMEOUT_MS = 10_000;\nconst COMMAND_SECRET_MAX_OUTPUT_BYTES = 1024 * 1024;\n\n/** Resolve a secret value, executing only a single leading `!` command marker. */\nexport function resolveCommandSecret(value: string, context: string): string;\nexport function resolveCommandSecret(value: undefined, context: string): undefined;\nexport function resolveCommandSecret(value: string | undefined, context: string): string | undefined;\nexport function resolveCommandSecret(value: string | undefined, context: string): string | undefined {\n\tif (value === undefined) return undefined;\n\tif (value.startsWith(\"!!\")) return interpolateEnvVars(value.slice(1));\n\tif (!value.startsWith(\"!\")) return interpolateEnvVars(value);\n\n\tconst result = spawnSync(value.slice(1), {\n\t\tshell: true,\n\t\tencoding: \"utf8\",\n\t\ttimeout: COMMAND_SECRET_TIMEOUT_MS,\n\t\tmaxBuffer: COMMAND_SECRET_MAX_OUTPUT_BYTES,\n\t\tstdio: [\"ignore\", \"pipe\", \"ignore\"],\n\t\twindowsHide: true,\n\t});\n\tif (result.error) {\n\t\tconst code = (result.error as NodeJS.ErrnoException).code;\n\t\tconst reason =\n\t\t\tcode === \"ETIMEDOUT\"\n\t\t\t\t? \"command timed out after 10 seconds\"\n\t\t\t\t: code === \"ENOBUFS\"\n\t\t\t\t\t? \"command output exceeded 1 MiB\"\n\t\t\t\t\t: \"command failed to start\";\n\t\tthrow new Error(`Failed to resolve ${context}: ${reason}`);\n\t}\n\tif (result.status !== 0) {\n\t\tthrow new Error(`Failed to resolve ${context}: command exited with code ${result.status ?? \"unknown\"}`);\n\t}\n\n\tconst resolved = result.stdout.trim();\n\tif (!resolved) throw new Error(`Failed to resolve ${context}: command returned empty output`);\n\treturn resolved;\n}\n\n/** Resolve command markers in a configured record without mutating the input. */\nexport function resolveCommandSecretsRecord(\n\tvalues: Record<string, string> | undefined,\n\tcontext: (key: string) => string,\n): Record<string, string> | undefined {\n\tif (!values) return undefined;\n\n\treturn Object.fromEntries(\n\t\tObject.entries(values).map(([key, value]) => [key, resolveCommandSecret(value, context(key))]),\n\t);\n}\n\nexport function resolveServerUrl(definition: Pick<ServerEntry, \"url\">): string | undefined {\n\tif (definition.url == null) return undefined;\n\tif (typeof definition.url !== \"string\") {\n\t\tthrow new Error(\"MCP server URL must be a string\");\n\t}\n\n\tconst missing = getMissingEnvVars(definition.url);\n\tif (missing.length > 0) {\n\t\tthrow new Error(\n\t\t\t`Missing environment variable${missing.length === 1 ? \"\" : \"s\"} in MCP server URL: ${missing.join(\", \")}`,\n\t\t);\n\t}\n\n\tconst resolved = interpolateEnvVars(definition.url);\n\ttry {\n\t\tnew URL(resolved);\n\t} catch (error) {\n\t\tthrow new Error(`Invalid MCP server URL after environment interpolation: ${resolved}`, { cause: error });\n\t}\n\treturn resolved;\n}\n\nexport function resolveConfigPath(value: string | undefined): string | undefined {\n\tif (value === undefined) return undefined;\n\n\tconst resolved = interpolateEnvVars(value);\n\tif (resolved === \"~\") return homedir();\n\tif (resolved.startsWith(\"~/\") || resolved.startsWith(\"~\\\\\")) {\n\t\treturn join(homedir(), resolved.slice(2));\n\t}\n\treturn resolved;\n}\n\nexport function resolveBearerToken(\n\tdefinition: Pick<ServerEntry, \"bearerToken\" | \"bearerTokenEnv\">,\n): string | undefined {\n\tif (definition.bearerToken !== undefined) {\n\t\treturn interpolateSecretExpression(definition.bearerToken);\n\t}\n\treturn definition.bearerTokenEnv ? process.env[definition.bearerTokenEnv] : undefined;\n}\n\n/** Remove OSC control strings, including payloads that have no terminator. */\nexport function stripOscSequences(text: string): string {\n\tlet result = \"\";\n\tlet index = 0;\n\twhile (index < text.length) {\n\t\tconst isEscOsc = text.charCodeAt(index) === 0x1b && text[index + 1] === \"]\";\n\t\tconst isC1Osc = text.charCodeAt(index) === 0x9d;\n\t\tif (!isEscOsc && !isC1Osc) {\n\t\t\tresult += text[index++];\n\t\t\tcontinue;\n\t\t}\n\n\t\tindex += isEscOsc ? 2 : 1;\n\t\twhile (index < text.length) {\n\t\t\tconst code = text.charCodeAt(index++);\n\t\t\tif (code === 0x07 || code === 0x9c) break;\n\t\t\tif (code === 0x1b && text[index] === \"\\\\\") {\n\t\t\t\tindex++;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t}\n\treturn result;\n}\n\nexport function sanitizeTerminalText(text: string): string {\n\treturn stripOscSequences(text)\n\t\t.replace(/(?:\\x1b\\[[0-?]*[ -/]*[@-~]|\\x1b[@-Z\\\\-_])/g, \"\")\n\t\t.replace(/[\\u0000-\\u001f\\u007f-\\u009f]+/g, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n}\n\nexport function formatTerminalError(error: unknown): string {\n\tconst messages: string[] = [];\n\tconst seen = new Set<unknown>();\n\tconst collect = (value: unknown) => {\n\t\tif (seen.has(value)) return;\n\t\tif ((typeof value === \"object\" && value !== null) || typeof value === \"function\") seen.add(value);\n\n\t\tif (value instanceof AggregateError) {\n\t\t\tconst countBefore = messages.length;\n\t\t\tfor (const nested of value.errors) collect(nested);\n\t\t\tif (value.cause !== undefined) collect(value.cause);\n\t\t\tif (messages.length === countBefore && value.message) messages.push(value.message);\n\t\t\treturn;\n\t\t}\n\t\tif (value instanceof Error) {\n\t\t\tif (value.message) messages.push(value.message);\n\t\t\tif (value.cause !== undefined) collect(value.cause);\n\t\t\treturn;\n\t\t}\n\t\tmessages.push(String(value));\n\t};\n\n\tcollect(error);\n\treturn sanitizeTerminalText([...new Set(messages)].join(\": \"));\n}\n\nexport function truncateAtWord(text: string, target: number): string {\n\tif (!text || text.length <= target) return text;\n\n\tconst truncated = text.slice(0, target);\n\tconst lastSpace = truncated.lastIndexOf(\" \");\n\n\tif (lastSpace > target * 0.6) {\n\t\treturn `${truncated.slice(0, lastSpace)}...`;\n\t}\n\n\treturn `${truncated}...`;\n}\n\nexport function normalizeDirectToolInputSchema(schema: unknown): Record<string, unknown> {\n\tconst inputSchema =\n\t\tschema && typeof schema === \"object\" && !Array.isArray(schema)\n\t\t\t? (schema as Record<string, unknown>)\n\t\t\t: { type: \"object\", properties: {} };\n\tconst normalized = { ...inputSchema };\n\tdelete normalized.$schema;\n\tdelete normalized.additionalProperties;\n\treturn normalized;\n}\n\nexport function normalizeToolArguments(value: unknown, context = \"tool arguments\"): Record<string, unknown> {\n\tif (value === undefined || value === null || value === \"\") return {};\n\n\tif (typeof value === \"string\") {\n\t\tconst trimmed = value.trim();\n\t\tif (trimmed === \"\") return {};\n\t\tlet parsed: unknown;\n\t\ttry {\n\t\t\tparsed = JSON.parse(trimmed);\n\t\t} catch (error) {\n\t\t\tthrow new Error(\n\t\t\t\t`${context}: invalid args JSON (${error instanceof SyntaxError ? error.message : String(error)}); ` +\n\t\t\t\t\t`pass args as a JSON object, or as a valid JSON string encoding one`,\n\t\t\t\t{ cause: error },\n\t\t\t);\n\t\t}\n\t\tif (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n\t\t\tthrow new Error(`${context}: expected a JSON object, got ${Array.isArray(parsed) ? \"array\" : typeof parsed}`);\n\t\t}\n\t\treturn parsed as Record<string, unknown>;\n\t}\n\n\tif (typeof value !== \"object\" || Array.isArray(value)) {\n\t\tthrow new Error(`${context}: expected a JSON object, got ${Array.isArray(value) ? \"array\" : typeof value}`);\n\t}\n\n\tassertJsonSerializable(value, context);\n\ttry {\n\t\treturn JSON.parse(JSON.stringify(value)) as Record<string, unknown>;\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`${context}: value is not JSON-serializable: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t{ cause: error },\n\t\t);\n\t}\n}\n\nfunction assertJsonSerializable(value: unknown, context: string, path = \"\"): void {\n\tif (value === null) return;\n\tif (typeof value === \"string\" || typeof value === \"boolean\") return;\n\tif (typeof value === \"number\") {\n\t\tif (!Number.isFinite(value)) throw new Error(`${context}: value at ${path || \"root\"} is not a finite number`);\n\t\treturn;\n\t}\n\tif (Array.isArray(value)) {\n\t\tfor (const [index, item] of value.entries()) assertJsonSerializable(item, context, `${path}[${index}]`);\n\t\treturn;\n\t}\n\tif (typeof value === \"object\") {\n\t\tif (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null) {\n\t\t\tthrow new Error(`${context}: value at ${path || \"root\"} is not a plain JSON object`);\n\t\t}\n\t\tif (Object.getOwnPropertySymbols(value).length > 0) {\n\t\t\tthrow new Error(`${context}: value at ${path || \"root\"} has symbol keys`);\n\t\t}\n\t\tfor (const [key, item] of Object.entries(value)) {\n\t\t\tassertJsonSerializable(item, context, path ? `${path}.${key}` : key);\n\t\t}\n\t\treturn;\n\t}\n\tthrow new Error(`${context}: value at ${path || \"root\"} is not JSON-serializable`);\n}\n\nexport function formatAuthRequiredMessage(\n\tconfig: Pick<McpConfig, \"settings\">,\n\tserverName: string,\n\tdefaultMessage: string,\n): string {\n\tconst template = config.settings?.authRequiredMessage;\n\treturn template ? template.replaceAll(`\\${server}`, serverName) : defaultMessage;\n}\n\nexport function formatMcpStatus(config: Pick<McpConfig, \"settings\">, message: string): string | undefined {\n\tif (config.settings?.mcpFooterStatus === \"off\") return undefined;\n\treturn `${config.settings?.showStatusIcon === false ? \"MCP: \" : \"🔌 MCP: \"}${message}`;\n}\n\n/**\n * Extract the adapter-owned UI stream mode from tool metadata.\n */\nexport function extractToolUiStreamMode(\n\ttoolMeta: Record<string, unknown> | undefined,\n): \"eager\" | \"stream-first\" | undefined {\n\tconst uiMeta = toolMeta?.ui;\n\tif (!uiMeta || typeof uiMeta !== \"object\") return undefined;\n\tconst streamMode = (uiMeta as Record<string, unknown>)[\"nexus-mcp.streamMode\"];\n\tif (streamMode === \"eager\" || streamMode === \"stream-first\") {\n\t\treturn streamMode;\n\t}\n\treturn undefined;\n}\n"]}