@vibesdotdev/integrations-meta 0.0.0-stage → 1.0.0-rc.0

package/dist/ai/providers/meta/muse-server/muse-failure.js

@@ -0,0 +1,226 @@
+/**
+ * Typed failures of the Muse server integration.
+ *
+ * Every failure is a `CapabilityError` with a code and a `reason` from the table
+ * below, and a message that is fixed per reason. Text the child wrote (a JSON-RPC
+ * `error.message`, a turn's error, stderr) never enters a message: it rides only
+ * in a bounded `cause` ({@link childTextCause}) the logger scrubs.
+ */
+import { CapabilityError, CaughtFailureSchema, isCapabilityError, valueFreeFailure } from '@vibesdotdev/kernel';
+import { boundedExcerpt } from '@vibesdotdev/external/jsonrpc';
+const FAILURES = {
+    'muse-transport-closed': {
+        code: 'UNAVAILABLE',
+        message: 'The Muse server connection is closed.',
+        retryable: true
+    },
+    'muse-process-exited': {
+        code: 'UNAVAILABLE',
+        message: 'The Muse server process ended.',
+        retryable: true
+    },
+    'muse-line-too-long': {
+        code: 'UNAVAILABLE',
+        message: 'The Muse server wrote a line longer than the declared maximum.',
+        retryable: false
+    },
+    'muse-envelope-unrecognized': {
+        code: 'UNAVAILABLE',
+        message: 'The Muse server wrote output that is not a JSON-RPC message.',
+        retryable: false
+    },
+    'muse-request-failed': {
+        code: 'UNAVAILABLE',
+        message: 'The Muse server answered a request with an error.',
+        retryable: false
+    },
+    'muse-request-timeout': {
+        code: 'TIMEOUT',
+        message: 'A Muse server request timed out.',
+        retryable: true
+    },
+    'muse-turn-failed': {
+        code: 'UNAVAILABLE',
+        message: 'The Muse turn did not complete.',
+        retryable: false
+    },
+    'muse-turn-cancelled': {
+        code: 'CANCELLED',
+        message: 'The Muse server reported the turn cancelled.',
+        retryable: false
+    },
+    'muse-turn-timeout': {
+        code: 'TIMEOUT',
+        message: 'The Muse turn timed out before it completed.',
+        retryable: true
+    },
+    'generation-cancelled': {
+        code: 'CANCELLED',
+        message: 'The generation was cancelled.',
+        retryable: false
+    },
+    'muse-output-too-large': {
+        code: 'UNAVAILABLE',
+        message: 'The Muse turn produced more output than the declared bound.',
+        retryable: false
+    },
+    'muse-notification-invalid': {
+        code: 'UNAVAILABLE',
+        message: 'The Muse server sent a notification of an unexpected shape.',
+        retryable: false
+    },
+    'approval-denied': {
+        code: 'PERMISSION_DENIED',
+        message: 'The Muse session asked for an approval the declared execution policy does not permit.',
+        retryable: false
+    },
+    'muse-user-input-requested': {
+        code: 'UNAVAILABLE',
+        message: 'The Muse session asked for user input, which a headless session cannot answer.',
+        retryable: false
+    },
+    'muse-approval-failed': {
+        code: 'UNAVAILABLE',
+        message: 'The Muse approval request could not be answered.',
+        retryable: false
+    },
+    'muse-listener-failed': {
+        code: 'INTERNAL',
+        message: 'A listener of the Muse server connection failed.',
+        retryable: false
+    },
+    'muse-transport-close-failed': {
+        code: 'UNAVAILABLE',
+        message: 'A Muse server connection could not be closed.',
+        retryable: false
+    },
+    'muse-cli-unavailable': {
+        code: 'UNAVAILABLE',
+        message: 'The Muse CLI is unavailable in the runtime environment.',
+        retryable: false
+    },
+    'muse-consumer-host-required': {
+        code: 'UNAVAILABLE',
+        message: 'Muse subscription execution requires a connected consumer host.',
+        retryable: false
+    },
+    'muse-session-program-missing': {
+        code: 'INTERNAL',
+        message: 'The selected spec did not provide a Muse session program.',
+        retryable: false
+    },
+    'muse-no-result': {
+        code: 'UNAVAILABLE',
+        message: 'The Muse session ended without a result.',
+        retryable: false
+    },
+    'response-shape-mismatch': {
+        code: 'UNAVAILABLE',
+        message: 'The Muse server answered with a result of an unexpected shape.',
+        retryable: false
+    },
+    'unsupported-option': {
+        code: 'INVALID_INPUT',
+        message: 'The Muse server spec does not support this request option.',
+        retryable: false
+    },
+    'unsupported-modality': {
+        code: 'INVALID_INPUT',
+        message: 'The Muse server spec only supports text generation.',
+        retryable: false
+    },
+    'unsupported-content': {
+        code: 'INVALID_INPUT',
+        message: 'The Muse server session carries text only: images, tools, tool calls and tool results are not supported.',
+        retryable: false
+    },
+    'invalid-connection': {
+        code: 'INVALID_INPUT',
+        message: 'The Meta connection configuration is not readable.',
+        retryable: false
+    },
+    'invalid-auth-method': {
+        code: 'INVALID_INPUT',
+        message: 'The Meta connection names an authentication method this provider does not support.',
+        retryable: false
+    },
+    'invalid-request': {
+        code: 'INVALID_INPUT',
+        message: 'The generation request is not a readable text request.',
+        retryable: false
+    },
+    'request-too-large': {
+        code: 'INVALID_INPUT',
+        message: 'The generation request is larger than the Muse server spec accepts.',
+        retryable: false
+    },
+    'invalid-transport-record': {
+        code: 'UNAVAILABLE',
+        message: 'The transport delivered a record the Muse spec cannot read.',
+        retryable: false
+    },
+    untyped: {
+        code: 'INTERNAL',
+        message: 'The Muse server failed unexpectedly.',
+        retryable: false
+    }
+};
+/** Every reason this integration raises, for the SPEC table and its test. */
+export const MUSE_FAILURE_REASONS = Object.freeze(Object.keys(FAILURES));
+/** Whether `reason` is one this integration raises. */
+export function isMuseFailureReason(reason) {
+    return Object.hasOwn(FAILURES, reason);
+}
+/**
+ * A typed failure with its reason's fixed message; `details` and `cause` are the caller's bounded facts.
+ * `retryable` overrides the reason's default only when the child judged the failure itself (MSP `TurnError.retryable`).
+ */
+export function museFailure(reason, extra = {}) {
+    const terms = FAILURES[reason];
+    const options = { reason, retryable: extra.retryable ?? terms.retryable };
+    if (extra.details !== undefined)
+        options.details = extra.details;
+    if (extra.cause !== undefined)
+        options.cause = extra.cause;
+    return new CapabilityError(terms.message, terms.code, options);
+}
+/**
+ * Text the child wrote, kept only as the `cause` of a typed failure: at most 200
+ * characters, with control, format and separator characters removed.
+ */
+export function childTextCause(text) {
+    return new Error(boundedExcerpt(text));
+}
+/** The failure of a JSON-RPC request or of the child, as the Muse reason that names it. */
+export function museFailureFrom(caught) {
+    const failure = CaughtFailureSchema.parse(caught);
+    // `isCapabilityError` never throws: a hostile value (a Proxy that traps `name`) is simply not typed.
+    // An untyped failure is known by its value-free facts and keeps the failure as its cause.
+    if (!isCapabilityError(failure)) {
+        return museFailure('untyped', { details: { failure: { ...valueFreeFailure(failure) } }, cause: failure });
+    }
+    // A failure that already carries one of this package's reasons is the answer as it is.
+    if (isMuseFailureReason(failure.reason))
+        return failure;
+    switch (failure.reason) {
+        case 'jsonrpc-child-exited':
+            return museFailure('muse-process-exited', { details: failure.details, cause: failure });
+        case 'jsonrpc-line-too-large':
+            return museFailure('muse-line-too-long', { cause: failure });
+        case 'jsonrpc-protocol-invalid':
+            return failure.details?.stage === 'result-schema' || failure.details?.stage === 'result-schema-threw'
+                ? museFailure('response-shape-mismatch', { cause: failure })
+                : museFailure('muse-envelope-unrecognized', { cause: failure });
+        case 'jsonrpc-closed':
+            return museFailure('muse-transport-closed', { cause: failure });
+        case 'jsonrpc-timeout':
+            return museFailure('muse-request-timeout', { cause: failure });
+        case 'jsonrpc-cancelled':
+            return museFailure('generation-cancelled', { cause: failure });
+        case 'jsonrpc-error':
+            return museFailure('muse-request-failed', { cause: failure });
+        default:
+            return failure;
+    }
+}
+//# sourceMappingURL=muse-failure.js.map

package/dist/ai/providers/meta/muse-server/muse-failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"muse-failure.js","sourceRoot":"","sources":["../../../../../src/ai/providers/meta/muse-server/muse-failure.ts"],"names":[],"mappings":"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"}

package/dist/ai/providers/meta/muse-server/muse-messages.d.ts

@@ -0,0 +1,19 @@
+import type { GenerationRequest } from '@vibesdotdev/ai/interfaces/adapter';
+import type { Modality } from '@vibesdotdev/ai/models/schemas/constants';
+/** Characters of prompt one request may carry (the sum of every message's content). */
+export declare const MUSE_MAX_PROMPT_CHARS = 4194304;
+export interface MuseTextMessage {
+    readonly role: 'system' | 'user' | 'assistant';
+    readonly content: string;
+}
+/**
+ * The conversation of a text request, or a typed refusal. A request that is not
+ * a text request (or cannot be read at all: a throwing getter, a trapping
+ * Proxy) is `unsupported-modality`; a malformed message list is
+ * `invalid-request`; content the text session cannot carry (an image, a tool
+ * call or result, native tools) is `unsupported-content` (never dropped); an
+ * oversize prompt is `request-too-large`. Nothing the request said is echoed
+ * into a message.
+ */
+export declare function readMuseTextMessages<M extends Modality>(request: GenerationRequest<M>): MuseTextMessage[];
+//# sourceMappingURL=muse-messages.d.ts.map

package/dist/ai/providers/meta/muse-server/muse-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"muse-messages.d.ts","sourceRoot":"","sources":["../../../../../src/ai/providers/meta/muse-server/muse-messages.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AAKzE,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,UAAY,CAAC;AAoB/C,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAmBD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,QAAQ,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,eAAe,EAAE,CAyBzG"}

package/dist/ai/providers/meta/muse-server/muse-messages.js

@@ -0,0 +1,83 @@
+import * as z from 'zod/v4';
+import { isTextRequest } from '@vibesdotdev/ai/specs/interfaces';
+import { attempt } from "../../../../failure-outcome.js";
+import { museFailure } from "./muse-failure.js";
+/** Characters of prompt one request may carry (the sum of every message's content). */
+export const MUSE_MAX_PROMPT_CHARS = 4_194_304;
+/** Messages one request may carry. */
+const MAX_MESSAGES = 4_096;
+/**
+ * What the Muse spec reads from a message. `images`, `toolCalls`, `toolCallId`
+ * and `toolName` are read only to be refused: a spec that flattens a
+ * conversation to text must not drop them.
+ */
+const MuseMessageSchema = z.object({
+    role: z.enum(['system', 'user', 'assistant', 'tool']),
+    content: z.string().max(MUSE_MAX_PROMPT_CHARS),
+    images: z.unknown().optional(),
+    toolCalls: z.unknown().optional(),
+    toolCallId: z.unknown().optional(),
+    toolName: z.unknown().optional()
+});
+const MuseMessagesSchema = z.array(MuseMessageSchema).min(1).max(MAX_MESSAGES);
+/** An empty list drops nothing. */
+const EmptyListSchema = z.array(z.never()).max(0);
+/** The one request member read to be refused: native tools the session cannot offer the model (an empty list drops nothing). */
+const ToolsSchema = z.object({ tools: EmptyListSchema.optional() });
+function unsupportedField(message) {
+    // A value a schema cannot even measure (a trapping Proxy) is not an empty list: it would be dropped.
+    const images = attempt(() => EmptyListSchema.safeParse(message.images));
+    if (message.images !== undefined && (images.failed || !images.value.success))
+        return 'images';
+    const toolCalls = attempt(() => EmptyListSchema.safeParse(message.toolCalls));
+    if (message.toolCalls !== undefined && (toolCalls.failed || !toolCalls.value.success))
+        return 'toolCalls';
+    if (message.toolCallId !== undefined)
+        return 'toolCallId';
+    if (message.toolName !== undefined)
+        return 'toolName';
+    return undefined;
+}
+/**
+ * The conversation of a text request, or a typed refusal. A request that is not
+ * a text request (or cannot be read at all: a throwing getter, a trapping
+ * Proxy) is `unsupported-modality`; a malformed message list is
+ * `invalid-request`; content the text session cannot carry (an image, a tool
+ * call or result, native tools) is `unsupported-content` (never dropped); an
+ * oversize prompt is `request-too-large`. Nothing the request said is echoed
+ * into a message.
+ */
+export function readMuseTextMessages(request) {
+    if (!isTextRequest(request))
+        throw museFailure('unsupported-modality');
+    const tools = attempt(() => ToolsSchema.safeParse(request));
+    if (tools.failed)
+        throw museFailure('invalid-request', { details: { stage: 'read' }, cause: tools.cause });
+    if (!tools.value.success)
+        throw museFailure('unsupported-content', { details: { field: 'tools' } });
+    const read = attempt(() => MuseMessagesSchema.safeParse(request.messages));
+    if (read.failed)
+        throw museFailure('invalid-request', { details: { stage: 'read' }, cause: read.cause });
+    if (!read.value.success) {
+        const issue = read.value.error.issues[0];
+        const tooLarge = issue?.code === 'too_big' && issue.path.at(-1) === 'content';
+        throw museFailure(tooLarge ? 'request-too-large' : 'invalid-request', {
+            details: { stage: 'schema', path: issue ? issue.path.map(String).join('.').slice(0, 64) : undefined }
+        });
+    }
+    const messages = [];
+    let total = 0;
+    for (const [index, message] of read.value.data.entries()) {
+        const unsupported = unsupportedField(message);
+        if (unsupported)
+            throw museFailure('unsupported-content', { details: { field: unsupported, index } });
+        if (message.role === 'tool')
+            throw museFailure('unsupported-content', { details: { field: 'role', index } });
+        total += message.content.length;
+        if (total > MUSE_MAX_PROMPT_CHARS)
+            throw museFailure('request-too-large', { details: { stage: 'total' } });
+        messages.push({ role: message.role, content: message.content });
+    }
+    return messages;
+}
+//# sourceMappingURL=muse-messages.js.map

package/dist/ai/providers/meta/muse-server/muse-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"muse-messages.js","sourceRoot":"","sources":["../../../../../src/ai/providers/meta/muse-server/muse-messages.ts"],"names":[],"mappings":"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"}

package/dist/ai/providers/meta/muse-server/muse-server.spec.descriptor.d.ts

@@ -0,0 +1,25 @@
+declare const _default: {
+    id: string;
+    kind: "ai/spec";
+    name: string;
+    description: string;
+    modalities: ("image" | "text" | "audio" | "video" | "embedding" | "transcription" | "evaluation" | "speech" | "ocr")[];
+    streamFraming: "none" | "sse" | "sse-named" | "ndjson" | "binary-chunked" | "ws-frame";
+    toolCallEnvelope: string;
+    transports: string[];
+    external: boolean;
+    priority: number;
+    enabled: boolean;
+    capabilities?: ("streaming" | "json_mode" | "text_generation" | "chat_completion" | "function_calling" | "embedding_generation" | "image_generation_text_to_image" | "image_generation_image_to_image" | "image_generation_inpainting" | "image_generation_outpainting" | "image_upscaling" | "image_editing_via_instructions" | "audio_generation_text_to_speech" | "audio_generation_voice_cloning" | "audio_generation_music" | "audio_generation_sound_effects" | "audio_transcription" | "audio_transcription_realtime" | "video_generation_text_to_video" | "workflow_execution" | "code_generation" | "image_understanding" | "structured_evaluation")[] | undefined;
+    imageControls?: {
+        steps: boolean;
+        cfg: boolean;
+        sampler: boolean;
+        scheduler: boolean;
+        negativePrompt: boolean;
+        seed: boolean;
+    } | undefined;
+    tags?: string[] | undefined;
+};
+export default _default;
+//# sourceMappingURL=muse-server.spec.descriptor.d.ts.map

package/dist/ai/providers/meta/muse-server/muse-server.spec.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"muse-server.spec.descriptor.d.ts","sourceRoot":"","sources":["../../../../../src/ai/providers/meta/muse-server/muse-server.spec.descriptor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAEA,wBAmBG"}

package/dist/ai/providers/meta/muse-server/muse-server.spec.descriptor.js

@@ -0,0 +1,21 @@
+import { createAISpecDescriptor } from '@vibesdotdev/ai/specs/schemas/descriptor';
+export default createAISpecDescriptor({
+    id: 'muse-server',
+    name: 'Meta Muse Server',
+    description: 'Subscription-backed, provider-managed agent turns over the persistent Meta Muse app-server MSP protocol.',
+    modalities: ['text'],
+    streamFraming: 'ndjson',
+    toolCallEnvelope: 'openai-tool-calls',
+    transports: ['muse-server'],
+    capabilities: ['text_generation', 'function_calling'],
+    priority: 110,
+    tags: [
+        'meta',
+        'muse',
+        'msp',
+        'meta-managed-auth',
+        'provider-managed-tool-loop',
+        'consumer-only'
+    ]
+});
+//# sourceMappingURL=muse-server.spec.descriptor.js.map

package/dist/ai/providers/meta/muse-server/muse-server.spec.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"muse-server.spec.descriptor.js","sourceRoot":"","sources":["../../../../../src/ai/providers/meta/muse-server/muse-server.spec.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAElF,eAAe,sBAAsB,CAAC;IACrC,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACV,0GAA0G;IAC3G,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,aAAa,EAAE,QAAQ;IACvB,gBAAgB,EAAE,mBAAmB;IACrC,UAAU,EAAE,CAAC,aAAa,CAAC;IAC3B,YAAY,EAAE,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IACrD,QAAQ,EAAE,GAAG;IACb,IAAI,EAAE;QACL,MAAM;QACN,MAAM;QACN,KAAK;QACL,mBAAmB;QACnB,4BAA4B;QAC5B,eAAe;KACf;CACD,CAAC,CAAC"}

package/dist/ai/providers/meta/muse-server/muse-server.spec.impl.d.ts

@@ -0,0 +1,33 @@
+import { type AISpecInterface, type DecodedEvent, type SpecCallContext, type WireRequest, type WireResponseChunk } from '@vibesdotdev/ai/specs/interfaces';
+import type { GenerationRequest } from '@vibesdotdev/ai/interfaces/adapter';
+import type { Modality } from '@vibesdotdev/ai/models/schemas/constants';
+declare class MuseServerSpec implements AISpecInterface {
+    readonly descriptor: {
+        id: string;
+        kind: "ai/spec";
+        name: string;
+        description: string;
+        modalities: ("image" | "text" | "audio" | "video" | "embedding" | "transcription" | "evaluation" | "speech" | "ocr")[];
+        streamFraming: "none" | "sse" | "sse-named" | "ndjson" | "binary-chunked" | "ws-frame";
+        toolCallEnvelope: string;
+        transports: string[];
+        external: boolean;
+        priority: number;
+        enabled: boolean;
+        capabilities?: ("streaming" | "json_mode" | "text_generation" | "chat_completion" | "function_calling" | "embedding_generation" | "image_generation_text_to_image" | "image_generation_image_to_image" | "image_generation_inpainting" | "image_generation_outpainting" | "image_upscaling" | "image_editing_via_instructions" | "audio_generation_text_to_speech" | "audio_generation_voice_cloning" | "audio_generation_music" | "audio_generation_sound_effects" | "audio_transcription" | "audio_transcription_realtime" | "video_generation_text_to_video" | "workflow_execution" | "code_generation" | "image_understanding" | "structured_evaluation")[] | undefined;
+        imageControls?: {
+            steps: boolean;
+            cfg: boolean;
+            sampler: boolean;
+            scheduler: boolean;
+            negativePrompt: boolean;
+            seed: boolean;
+        } | undefined;
+        tags?: string[] | undefined;
+    };
+    encodeRequest<M extends Modality>(request: GenerationRequest<M>, context: SpecCallContext): WireRequest;
+    decodeResponse<M extends Modality>(chunks: AsyncIterable<WireResponseChunk>, request: GenerationRequest<M>, context: SpecCallContext): AsyncIterable<DecodedEvent<M>>;
+}
+declare const _default: MuseServerSpec;
+export default _default;
+//# sourceMappingURL=muse-server.spec.impl.d.ts.map

package/dist/ai/providers/meta/muse-server/muse-server.spec.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"muse-server.spec.impl.d.ts","sourceRoot":"","sources":["../../../../../src/ai/providers/meta/muse-server/muse-server.spec.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,KAAK,EAAE,iBAAiB,EAA0B,MAAM,oCAAoC,CAAC;AACpG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AAuCzE,cAAM,cAAe,YAAW,eAAe;IAC9C,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;MAAc;IAEjC,aAAa,CAAC,CAAC,SAAS,QAAQ,EAC/B,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC7B,OAAO,EAAE,eAAe,GACtB,WAAW;IAmDP,cAAc,CAAC,CAAC,SAAS,QAAQ,EACvC,MAAM,EAAE,aAAa,CAAC,iBAAiB,CAAC,EACxC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC7B,OAAO,EAAE,eAAe,GACtB,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAmDjC;;AA8DD,wBAAoC"}

package/dist/ai/providers/meta/muse-server/muse-server.spec.impl.js

@@ -0,0 +1,192 @@
+import { isTextRequest, textResultEvent } from '@vibesdotdev/ai/specs/interfaces';
+import * as z from 'zod/v4';
+import { JsonObjectSchema } from '@vibesdotdev/kernel/schemas/json';
+import { attempt } from "../../../../failure-outcome.js";
+import descriptor from "./muse-server.spec.descriptor.js";
+import { museFailure } from "./muse-failure.js";
+import { readMuseTextMessages } from "./muse-messages.js";
+import { MuseServerRecordSchema } from "./protocol.js";
+import { createMuseServerSessionProgram } from "./session.js";
+/** The reasoning efforts a request may name (the vendor-neutral vocabulary of the text request). */
+const EffortSchema = z.enum(['none', 'low', 'medium', 'high', 'xhigh', 'max']).optional();
+/** The part of the call's declared execution policy (`AIExecutionPolicy`) that sets the approval posture. */
+const PolicySchema = z.object({
+    sandboxMode: z.enum(['read-only', 'workspace-write', 'danger-full-access']).optional(),
+    approvalPolicy: z.enum(['untrusted', 'on-failure', 'on-request', 'never']).optional()
+});
+/** The workspace path the policy declares; anything but a string is not a path. */
+const WorkspacePathSchema = z.string().optional();
+/**
+ * The approval posture of a session. Unmatched approvals are denied unless the call
+ * declares an execution policy that permits them: full access (`danger-full-access`)
+ * with no approval prompts (`approvalPolicy: 'never'`), the same rule as Codex and
+ * Antigravity. A read-only or workspace-write policy never approves a write or a
+ * shell command, whatever its approval policy. Nothing is inferred: an absent or
+ * unreadable policy is the denying posture.
+ */
+function approvalModeFor(policy) {
+    return policy.sandboxMode === 'danger-full-access' && policy.approvalPolicy === 'never' ? 'allowAll' : 'denyUnmatched';
+}
+class MuseServerSpec {
+    descriptor = descriptor;
+    encodeRequest(request, context) {
+        // Refuses images, tools, tool calls and tool results typed: the session carries text only, and nothing is dropped.
+        const messages = readMuseTextMessages(request);
+        if (!isTextRequest(request))
+            throw museFailure('unsupported-modality');
+        const modelId = resolveMuseModel(context.wireModelId);
+        const requested = attempt(() => request.reasoningEffort);
+        if (requested.failed) {
+            throw museFailure('invalid-request', { details: { stage: 'read' }, cause: requested.cause });
+        }
+        const declared = EffortSchema.safeParse(requested.value);
+        if (!declared.success)
+            throw museFailure('unsupported-option', { details: { option: 'reasoningEffort' } });
+        const effort = toMuseEffort(declared.data);
+        // The policy is read once, inside the guard: a hostile getter or Proxy on it is a typed refusal.
+        const policy = attempt(() => {
+            const raw = context.executionPolicy;
+            return { posture: PolicySchema.safeParse(raw ?? {}), workspacePath: WorkspacePathSchema.safeParse(raw?.workspacePath) };
+        });
+        if (policy.failed)
+            throw museFailure('invalid-request', { details: { stage: 'policy' }, cause: policy.cause });
+        if (!policy.value.workspacePath.success)
+            throw museFailure('invalid-request', { details: { stage: 'policy' } });
+        // A policy that does not parse declares nothing: the posture stays denying.
+        const declaredPolicy = policy.value.posture.success ? policy.value.posture.data : {};
+        const workspacePath = policy.value.workspacePath.data ?? '.';
+        const jsonSchema = attempt(() => JsonObjectSchema.optional().safeParse(request.jsonSchema));
+        if (jsonSchema.failed) {
+            throw museFailure('invalid-request', { details: { stage: 'read' }, cause: jsonSchema.cause });
+        }
+        if (!jsonSchema.value.success)
+            throw museFailure('invalid-request', { details: { stage: 'jsonSchema' } });
+        const body = {
+            model: modelId,
+            workspaceRoot: workspacePath.replace(/\\/g, '/'),
+            approvalMode: approvalModeFor(declaredPolicy),
+            input: encodeTurnInput(messages, jsonSchema.value.data),
+            reasoningEffort: effort
+        };
+        return {
+            method: 'POST',
+            path: '',
+            headers: { 'content-type': 'application/x-ndjson' },
+            body: {
+                ...body,
+                sessionProgram: createMuseServerSessionProgram(body)
+            },
+            streaming: true
+        };
+    }
+    async *decodeResponse(chunks, request, context) {
+        let resultSeen = false;
+        for await (const chunk of chunks) {
+            if (chunk.kind === 'error') {
+                yield { kind: 'error', error: chunk.error };
+                return;
+            }
+            if (chunk.kind !== 'ndjson-record')
+                continue;
+            const record = parseRecord(chunk.data);
+            // A record the session never writes, or any record after the result: the stream cannot be trusted.
+            if (!record.ok) {
+                yield {
+                    kind: 'error',
+                    error: museFailure('invalid-transport-record', { details: { problem: record.problem }, cause: record.cause })
+                };
+                return;
+            }
+            if (resultSeen) {
+                yield { kind: 'error', error: museFailure('invalid-transport-record', { details: { problem: 'record-after-result' } }) };
+                return;
+            }
+            if (record.value.type === 'text-delta') {
+                yield { kind: 'text-delta', delta: record.value.delta };
+                continue;
+            }
+            const final = record.value;
+            const result = {
+                id: `${context.providerId}.${final.sessionId}.${final.turnId}`,
+                timestamp: new Date(),
+                content: final.content,
+                toolCalls: final.toolExecutions.map((tool) => ({
+                    id: tool.id,
+                    name: tool.name,
+                    arguments: tool.arguments,
+                    result: tool.result
+                })),
+                metadata: {
+                    modelVersion: context.wireModelId,
+                    finishReason: 'stop',
+                    providerManagedToolLoop: true,
+                    executedToolCount: final.toolExecutions.length,
+                    executedTools: final.toolExecutions
+                }
+            };
+            yield textResultEvent(request, result);
+            // The stream is read to its end, so the transport finishes (and stops the turn) in the normal flow.
+            resultSeen = true;
+        }
+        // The session ended without its result record: never an empty success.
+        if (!resultSeen)
+            yield { kind: 'error', error: museFailure('muse-no-result') };
+    }
+}
+function parseRecord(text) {
+    const decoded = attempt(() => JSON.parse(text));
+    if (decoded.failed)
+        return { ok: false, problem: 'not-json', cause: decoded.cause };
+    const parsed = MuseServerRecordSchema.safeParse(decoded.value);
+    return parsed.success ? { ok: true, value: parsed.data } : { ok: false, problem: 'unrecognized-record' };
+}
+function resolveMuseModel(wireModelId) {
+    if (!wireModelId)
+        return 'muse-spark-1.3';
+    const stripped = wireModelId.replace(/^meta[:/]/, '').replace(/^meta-/, '');
+    if (stripped === 'muse-spark-1-3' || stripped === 'muse-spark-1.3')
+        return 'muse-spark-1.3';
+    if (stripped === 'muse-spark-1-2' || stripped === 'muse-spark-1.2')
+        return 'muse-spark-1.2';
+    if (stripped === 'muse-spark-1-1' || stripped === 'muse-spark-1.1')
+        return 'muse-spark-1.1';
+    return stripped;
+}
+/**
+ * Muse always reasons and has three efforts: `none` is clamped up to `low`, the
+ * two highest tiers down to `high`. A value that is not a declared effort is
+ * refused, never guessed.
+ */
+function toMuseEffort(effort) {
+    switch (effort) {
+        case undefined:
+        case 'medium':
+            return 'medium';
+        case 'none':
+        case 'low':
+            return 'low';
+        case 'high':
+        case 'xhigh':
+        case 'max':
+            return 'high';
+    }
+}
+function encodeTurnInput(messages, jsonSchema) {
+    const encoded = messages
+        .map((message) => {
+        const rolePrefix = message.role === 'user' ? '' : message.role === 'system' ? '[Instruction]\n' : '';
+        return `${rolePrefix}${message.content}`.trim();
+    })
+        .filter(Boolean)
+        .join('\n\n');
+    const serialized = attempt(() => jsonSchema ? JSON.stringify(jsonSchema) : undefined);
+    if (serialized.failed)
+        throw museFailure('invalid-request', { details: { stage: 'jsonSchema' }, cause: serialized.cause });
+    const schemaText = serialized.value;
+    const text = schemaText && !encoded.includes(schemaText)
+        ? `${encoded}\n\n<output_schema>\nReturn only a JSON value matching this JSON Schema (no markdown fences or surrounding prose):\n${schemaText}\n</output_schema>`
+        : encoded;
+    return [{ type: 'text', text: text || 'Continue' }];
+}
+export default new MuseServerSpec();
+//# sourceMappingURL=muse-server.spec.impl.js.map