@fnndsc/calypso 0.6.1 → 0.7.0

package/dist/protocol/messages.js

@@ -1,281 +0,0 @@
-/**
- * @file The wire-contract message schemas.
- *
- * Two discriminated unions, one per direction, keyed on a `type` tag:
- * {@link clientMessageSchema} (surface → daemon) and
- * {@link serverMessageSchema} (daemon → surface). Every request carries a
- * correlation `id` so its reply and any streamed output can be matched to
- * it, and output events carry the sink channel they belong to. These schemas
- * are the single source of truth for the protocol; the human-readable
- * description in `docs/calypso.adoc` is checked against them.
- *
- * @module
- */
-import { z } from 'zod';
-import { PROC_PROMPT_STATES } from '@fnndsc/cumin/proc-prompt';
-import { PROGRESS_KINDS, PROGRESS_OPERATIONS, PROGRESS_PHASES, PROGRESS_STATUSES, PROGRESS_UNITS, } from '@fnndsc/brasa/progress';
-import { commandEnvelopeSchema } from './envelope.js';
-/** The sink channel an output event belongs to. */
-export const channelSchema = z.enum(['data', 'err', 'status']);
-// --- Surface → daemon ------------------------------------------------------
-/** Capabilities an attaching surface can safely execute on its own machine. */
-export const surfaceCapabilitiesMessageSchema = z.object({
-    shellCommands: z.boolean(),
-    hiddenInput: z.boolean().optional(),
-});
-/** Attach to a session: declares the contract version, token, and surface capabilities. */
-export const attachMessageSchema = z.object({
-    type: z.literal('attach'),
-    protocolVersion: z.number().int(),
-    token: z.string(),
-    session: z.string().optional(),
-    capabilities: surfaceCapabilitiesMessageSchema.optional(),
-});
-/** Execute one input line, correlated by `id`. */
-export const executeMessageSchema = z.object({
-    type: z.literal('execute'),
-    id: z.string(),
-    line: z.string(),
-});
-/** Requests cancellation of the caller's currently executing command. */
-export const cancelMessageSchema = z.object({
-    type: z.literal('cancel'),
-    id: z.string(),
-});
-/** Request completion candidates for a partial line, correlated by `id`. */
-export const completeRequestSchema = z.object({
-    type: z.literal('complete'),
-    id: z.string(),
-    prefix: z.string(),
-});
-/** Answers a prompt the daemon requested during a command, correlated by `promptId`. */
-export const promptAnswerMessageSchema = z.object({
-    type: z.literal('promptAnswer'),
-    promptId: z.string(),
-    answer: z.string(),
-});
-/** Reports a prompt failure to the daemon (surface cannot or did not answer), correlated by `promptId`. */
-export const promptErrorMessageSchema = z.object({
-    type: z.literal('promptError'),
-    promptId: z.string(),
-    reason: z.string(),
-});
-/** Returns the output of a pipeline segment the daemon asked the surface to run, correlated by `pipeId`. */
-export const pipeResultMessageSchema = z.object({
-    type: z.literal('pipeResult'),
-    pipeId: z.string(),
-    output: z.string(),
-});
-/** Returns a pipeline-segment failure to the daemon, correlated by `pipeId`. */
-export const pipeErrorMessageSchema = z.object({
-    type: z.literal('pipeError'),
-    pipeId: z.string(),
-    reason: z.string(),
-});
-/** Returns the exit code of a shell command the daemon asked the surface to run. */
-export const shellResultMessageSchema = z.object({
-    type: z.literal('shellResult'),
-    shellId: z.string(),
-    exitCode: z.number().int(),
-});
-/** Returns a surface shell-launch failure to the daemon, correlated by `shellId`. */
-export const shellErrorMessageSchema = z.object({
-    type: z.literal('shellError'),
-    shellId: z.string(),
-    reason: z.string(),
-});
-/** Returns the edited content from a local-edit the daemon requested, correlated by `editId`. */
-export const editResultMessageSchema = z.object({
-    type: z.literal('editResult'),
-    editId: z.string(),
-    content: z.string(),
-    changed: z.boolean(),
-});
-/** Reports a local-edit failure to the daemon, correlated by `editId`. */
-export const editErrorMessageSchema = z.object({
-    type: z.literal('editError'),
-    editId: z.string(),
-    reason: z.string(),
-});
-/** Any message a surface may send to the daemon. */
-export const clientMessageSchema = z.discriminatedUnion('type', [
-    attachMessageSchema,
-    executeMessageSchema,
-    cancelMessageSchema,
-    completeRequestSchema,
-    promptAnswerMessageSchema,
-    promptErrorMessageSchema,
-    pipeResultMessageSchema,
-    pipeErrorMessageSchema,
-    shellResultMessageSchema,
-    shellErrorMessageSchema,
-    editResultMessageSchema,
-    editErrorMessageSchema,
-]);
-// --- Daemon → surface ------------------------------------------------------
-/**
- * Acknowledges a successful attach. The optional `stack` block reports the
- * daemon's own installed versions and build hash, so a remote surface can
- * greet with the truth of the process it attached to rather than whatever is
- * installed client-side; older daemons simply omit it.
- */
-export const attachedMessageSchema = z.object({
-    type: z.literal('attached'),
-    session: z.string(),
-    protocolVersion: z.number().int(),
-    stack: z
-        .object({
-        chell: z.string(),
-        calypso: z.string(),
-        build: z.string(),
-        brasa: z.string().optional(),
-        chili: z.string().optional(),
-        salsa: z.string().optional(),
-        cumin: z.string().optional(),
-    })
-        .optional(),
-});
-/** The final result of one executed line: one envelope per command. */
-export const resultMessageSchema = z.object({
-    type: z.literal('result'),
-    id: z.string(),
-    envelopes: z.array(commandEnvelopeSchema),
-});
-/** The reply to a completion request. */
-export const completeReplySchema = z.object({
-    type: z.literal('complete'),
-    id: z.string(),
-    prefix: z.string(),
-    candidates: z.array(z.string()),
-});
-/** A streamed output event on one channel, correlated to its command. */
-export const outputMessageSchema = z.object({
-    type: z.literal('output'),
-    id: z.string(),
-    channel: channelSchema,
-    chunk: z.string(),
-});
-/** The operation producing structured progress. */
-export const progressOperationSchema = z.enum(PROGRESS_OPERATIONS);
-/** Broad class of progress producer. */
-export const progressKindSchema = z.enum(PROGRESS_KINDS);
-/** Lifecycle phase of a progress operation. */
-export const progressPhaseSchema = z.enum(PROGRESS_PHASES);
-/** Unit used by the primary progress counter. */
-export const progressUnitSchema = z.enum(PROGRESS_UNITS);
-/** State of the operation or item being reported. */
-export const progressStatusSchema = z.enum(PROGRESS_STATUSES);
-/** A structured progress event correlated to a command. */
-export const progressMessageSchema = z.object({
-    type: z.literal('progress'),
-    id: z.string(),
-    operation: progressOperationSchema,
-    kind: progressKindSchema.optional(),
-    phase: progressPhaseSchema,
-    label: z.string().optional(),
-    itemId: z.string().optional(),
-    current: z.number().nonnegative().optional(),
-    total: z.number().nonnegative().optional(),
-    percent: z.number().min(0).max(100).optional(),
-    unit: progressUnitSchema.optional(),
-    status: progressStatusSchema.optional(),
-});
-/** A session-bus broadcast: an envelope tagged with its originating surface. */
-export const sessionMessageSchema = z.object({
-    type: z.literal('session'),
-    surface: z.string(),
-    envelope: commandEnvelopeSchema,
-});
-/** A boundary error: a refused attach, a malformed message, correlated when possible. */
-export const errorMessageSchema = z.object({
-    type: z.literal('error'),
-    id: z.string().optional(),
-    reason: z.string(),
-});
-/**
- * A prompt request the daemon raises during a command: the surface that
- * submitted the command must answer it (with `promptAnswer`) before the
- * command can proceed. `hidden` requests no-echo entry (password).
- */
-export const promptMessageSchema = z.object({
-    type: z.literal('prompt'),
-    promptId: z.string(),
-    message: z.string(),
-    hidden: z.boolean(),
-});
-/**
- * The engine-known facts a prompt reflects, independent of any theme.
- *
- * The daemon knows the session context but not how a given surface renders it,
- * so it ships these facts and each surface themes them with its own settings.
- * Rendering inputs a surface owns (theme, segments, terminal width) are not
- * carried here.
- */
-export const promptContextSchema = z.object({
-    user: z.string(),
-    uri: z.string(),
-    cwd: z.string(),
-    pacsserver: z.string().nullable(),
-    physicalMode: z.boolean(),
-    lastExitCode: z.number(),
-    lastCommandDurationMs: z.number(),
-    procWarmup: z.object({
-        loaded: z.number(),
-        total: z.number().optional(),
-        restored: z.boolean().optional(),
-        state: z.enum(PROC_PROMPT_STATES).optional(),
-    }).optional(),
-});
-/**
- * The prompt context, pushed by the daemon with each result and on any context
- * change. The daemon knows the session context; each surface renders it with
- * its own theme, so prompt themes are a per-surface choice rather than the
- * daemon's.
- */
-export const promptLineMessageSchema = z.object({
-    type: z.literal('promptline'),
-    context: promptContextSchema,
-});
-/**
- * Asks the surface to run a pipeline segment on its own machine (never on the
- * daemon host) and return the output. `input` and the reply's `output` are
- * base64, since segment data is arbitrary bytes.
- */
-export const pipeMessageSchema = z.object({
-    type: z.literal('pipe'),
-    pipeId: z.string(),
-    command: z.string(),
-    input: z.string(),
-});
-/** Asks the surface to run a shell command on its own machine, never on the daemon host. */
-export const shellMessageSchema = z.object({
-    type: z.literal('shell'),
-    shellId: z.string(),
-    command: z.string(),
-});
-/**
- * Asks the surface to open content in its local editor (never on the daemon
- * host) and return the edited result.
- */
-export const editMessageSchema = z.object({
-    type: z.literal('edit'),
-    editId: z.string(),
-    content: z.string(),
-    extension: z.string().optional(),
-});
-/** Any message the daemon may send to a surface. */
-export const serverMessageSchema = z.discriminatedUnion('type', [
-    attachedMessageSchema,
-    resultMessageSchema,
-    completeReplySchema,
-    outputMessageSchema,
-    progressMessageSchema,
-    sessionMessageSchema,
-    errorMessageSchema,
-    promptMessageSchema,
-    promptLineMessageSchema,
-    pipeMessageSchema,
-    shellMessageSchema,
-    editMessageSchema,
-]);
-//# sourceMappingURL=messages.js.map

package/dist/protocol/messages.js.map

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

package/dist/protocol/validate.d.ts

@@ -1,57 +0,0 @@
-/**
- * @file Boundary validation.
- *
- * Every message is validated on the way in and out. Structural violations
- * (missing required fields, wrong types, an unknown `type`) are rejected;
- * unknown *additional* fields are tolerated (stripped), so a daemon accepts
- * additive extensions from a newer minor without understanding them. Parsing
- * never throws — it returns a {@link ParseResult} so the caller can answer a
- * malformed message with an `error` message rather than dropping the socket.
- *
- * @module
- */
-import { z } from 'zod';
-import { attachMessageSchema, type ClientMessage, type ServerMessage } from './messages.js';
-/**
- * The outcome of validating a message at the boundary.
- *
- * @property ok - Whether the input was a valid message.
- * @property value - The parsed message, when `ok`.
- * @property error - A human-readable reason, when not `ok`.
- */
-export interface ParseResult<T> {
-    ok: boolean;
-    value?: T;
-    error?: string;
-}
-/**
- * Validates a message a surface sent to the daemon.
- *
- * @param raw - The untrusted input (already JSON-parsed).
- * @returns The parse result.
- */
-export declare function clientMessage_parse(raw: unknown): ParseResult<ClientMessage>;
-/**
- * Validates a message the daemon sent to a surface.
- *
- * @param raw - The untrusted input (already JSON-parsed).
- * @returns The parse result.
- */
-export declare function serverMessage_parse(raw: unknown): ParseResult<ServerMessage>;
-/**
- * Parses a JSON string into a client message, rejecting both malformed JSON
- * and structurally invalid messages with a clear reason.
- *
- * @param json - The raw JSON text received on the socket.
- * @returns The parse result.
- */
-export declare function clientMessage_fromJson(json: string): ParseResult<ClientMessage>;
-/**
- * Validates an attach message and checks its declared contract version
- * against this build. A structurally valid attach on an incompatible major
- * is rejected with a clear reason.
- *
- * @param raw - The untrusted input (already JSON-parsed).
- * @returns The parse result; an incompatible version is a validation failure.
- */
-export declare function attach_parse(raw: unknown): ParseResult<z.infer<typeof attachMessageSchema>>;

package/dist/protocol/validate.js

@@ -1,88 +0,0 @@
-import { clientMessageSchema, serverMessageSchema, attachMessageSchema, } from './messages.js';
-import { version_isCompatible } from './version.js';
-/**
- * Formats a Zod error into a compact, single-line boundary reason.
- *
- * @param error - The Zod validation error.
- * @returns A human-readable reason string.
- */
-function zodError_format(error) {
-    return error.issues
-        .map((issue) => {
-        const path = issue.path.join('.');
-        return path ? `${path}: ${issue.message}` : issue.message;
-    })
-        .join('; ');
-}
-/**
- * Validates a raw value against a schema, never throwing.
- *
- * @param schema - The schema to validate against.
- * @param raw - The untrusted input.
- * @returns The parse result.
- */
-function schema_parse(schema, raw) {
-    const result = schema.safeParse(raw);
-    if (result.success) {
-        return { ok: true, value: result.data };
-    }
-    return { ok: false, error: zodError_format(result.error) };
-}
-/**
- * Validates a message a surface sent to the daemon.
- *
- * @param raw - The untrusted input (already JSON-parsed).
- * @returns The parse result.
- */
-export function clientMessage_parse(raw) {
-    return schema_parse(clientMessageSchema, raw);
-}
-/**
- * Validates a message the daemon sent to a surface.
- *
- * @param raw - The untrusted input (already JSON-parsed).
- * @returns The parse result.
- */
-export function serverMessage_parse(raw) {
-    return schema_parse(serverMessageSchema, raw);
-}
-/**
- * Parses a JSON string into a client message, rejecting both malformed JSON
- * and structurally invalid messages with a clear reason.
- *
- * @param json - The raw JSON text received on the socket.
- * @returns The parse result.
- */
-export function clientMessage_fromJson(json) {
-    let parsed;
-    try {
-        parsed = JSON.parse(json);
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { ok: false, error: `malformed JSON: ${message}` };
-    }
-    return clientMessage_parse(parsed);
-}
-/**
- * Validates an attach message and checks its declared contract version
- * against this build. A structurally valid attach on an incompatible major
- * is rejected with a clear reason.
- *
- * @param raw - The untrusted input (already JSON-parsed).
- * @returns The parse result; an incompatible version is a validation failure.
- */
-export function attach_parse(raw) {
-    const parsed = schema_parse(attachMessageSchema, raw);
-    if (!parsed.ok || parsed.value === undefined) {
-        return parsed;
-    }
-    if (!version_isCompatible(parsed.value.protocolVersion)) {
-        return {
-            ok: false,
-            error: `incompatible contract version ${parsed.value.protocolVersion}`,
-        };
-    }
-    return parsed;
-}
-//# sourceMappingURL=validate.js.map

package/dist/protocol/validate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/protocol/validate.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAepD;;;;;GAKG;AACH,SAAS,eAAe,CAAC,KAAiB;IACxC,OAAO,KAAK,CAAC,MAAM;SAChB,GAAG,CAAC,CAAC,KAAiB,EAAU,EAAE;QACjC,MAAM,IAAI,GAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;IAC5D,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY,CAAI,MAAoB,EAAE,GAAY;IACzD,MAAM,MAAM,GAAsC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACxE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,OAAO,YAAY,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,OAAO,YAAY,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAW,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,OAAO,EAAE,EAAE,CAAC;IAC5D,CAAC;IACD,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,MAAM,MAAM,GAAqD,YAAY,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACxG,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7C,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;QACxD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,iCAAiC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE;SACvE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/protocol/version.d.ts

@@ -1,25 +0,0 @@
-/**
- * @file The wire-contract version and its compatibility rule.
- *
- * The contract version is carried by a client in the attach handshake and
- * refused by the daemon on mismatch, with no silent degradation. Per
- * `docs/calypso.adoc`, it tracks the calypso package's major version at
- * release; within a major, changes are additive only (new message types,
- * new optional fields, new model kinds), so a daemon tolerates unknown
- * additions from a newer minor but rejects a different major outright.
- *
- * @module
- */
-/**
- * The wire-contract major version this build speaks.
- */
-export declare const CONTRACT_VERSION: number;
-/**
- * Decides whether a client's declared contract version is compatible with
- * this build. Compatibility is exact-major: a client on a different major is
- * refused, because a major bump removes or re-types something.
- *
- * @param clientVersion - The contract major the client declared at attach.
- * @returns True when the client may attach.
- */
-export declare function version_isCompatible(clientVersion: number): boolean;

package/dist/protocol/version.js

@@ -1,28 +0,0 @@
-/**
- * @file The wire-contract version and its compatibility rule.
- *
- * The contract version is carried by a client in the attach handshake and
- * refused by the daemon on mismatch, with no silent degradation. Per
- * `docs/calypso.adoc`, it tracks the calypso package's major version at
- * release; within a major, changes are additive only (new message types,
- * new optional fields, new model kinds), so a daemon tolerates unknown
- * additions from a newer minor but rejects a different major outright.
- *
- * @module
- */
-/**
- * The wire-contract major version this build speaks.
- */
-export const CONTRACT_VERSION = 1;
-/**
- * Decides whether a client's declared contract version is compatible with
- * this build. Compatibility is exact-major: a client on a different major is
- * refused, because a major bump removes or re-types something.
- *
- * @param clientVersion - The contract major the client declared at attach.
- * @returns True when the client may attach.
- */
-export function version_isCompatible(clientVersion) {
-    return clientVersion === CONTRACT_VERSION;
-}
-//# sourceMappingURL=version.js.map

package/dist/protocol/version.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/protocol/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAW,CAAC,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAqB;IACxD,OAAO,aAAa,KAAK,gBAAgB,CAAC;AAC5C,CAAC"}