@fnndsc/calypso 0.6.1 → 0.7.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fnndsc/calypso",
-  "version": "0.6.1",
-  "description": "The CALYPSO wire contract: typed protocol schemas and boundary validation for the ChRIS session daemon",
+  "version": "0.7.1",
+  "description": "CALYPSO: the ChRIS session daemon — hosts a brasa engine for attached surfaces over a WebSocket",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/FNNDSC/mise.git",
@@ -26,10 +26,6 @@
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     },
-    "./protocol": {
-      "import": "./dist/protocol/index.js",
-      "types": "./dist/protocol/index.d.ts"
-    },
     "./package.json": "./package.json"
   },
   "scripts": {
@@ -55,10 +51,11 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "@fnndsc/brasa": "^0.12.0",
-    "@fnndsc/cumin": "^3.11.0",
+    "@fnndsc/brasa": "^0.14.0",
+    "@fnndsc/cumin": "^3.15.0",
     "chalk": "^4.1.2",
     "ws": "^8.18.0",
-    "zod": "^3.23.8"
+    "zod": "^3.23.8",
+    "@fnndsc/menu": "*"
   }
 }

package/dist/protocol/envelope.d.ts

@@ -1,136 +0,0 @@
-/**
- * @file The wire schema for a command envelope.
- *
- * cumin defines the `CommandEnvelope` type (the shape produced in-stack);
- * calypso owns the wire schema that validates that envelope at the boundary
- * — the published promise an external surface programs against. The two are
- * kept in step by a compile-time check below: if cumin's type gains a field
- * the wire schema does not cover, this file stops compiling, so the contract
- * can never silently drift from what the code produces.
- *
- * @module
- */
-import { z } from 'zod';
-/** Terminal status of a completed command. */
-export declare const envelopeStatusSchema: z.ZodEnum<["ok", "error"]>;
-/** A single structured error/warning drained from the error stack. */
-export declare const stackMessageSchema: z.ZodObject<{
-    type: z.ZodEnum<["error", "warning"]>;
-    message: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    type: "error" | "warning";
-    message: string;
-}, {
-    type: "error" | "warning";
-    message: string;
-}>;
-/** A command's typed result: a namespaced kind and an opaque payload. */
-export declare const envelopeModelSchema: z.ZodObject<{
-    kind: z.ZodString;
-    data: z.ZodUnknown;
-}, "strip", z.ZodTypeAny, {
-    kind: string;
-    data?: unknown;
-}, {
-    kind: string;
-    data?: unknown;
-}>;
-/** The record of how a natural-language input resolved into a command. */
-export declare const resolutionTraceSchema: z.ZodObject<{
-    input: z.ZodString;
-    proposed: z.ZodString;
-    validated: z.ZodBoolean;
-    executed: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    input: string;
-    proposed: string;
-    validated: boolean;
-    executed?: string | undefined;
-}, {
-    input: string;
-    proposed: string;
-    validated: boolean;
-    executed?: string | undefined;
-}>;
-/**
- * The envelope in which one command's complete outcome crosses the wire.
- */
-export declare const commandEnvelopeSchema: z.ZodObject<{
-    status: z.ZodEnum<["ok", "error"]>;
-    rendered: z.ZodString;
-    renderedErr: z.ZodOptional<z.ZodString>;
-    model: z.ZodOptional<z.ZodObject<{
-        kind: z.ZodString;
-        data: z.ZodUnknown;
-    }, "strip", z.ZodTypeAny, {
-        kind: string;
-        data?: unknown;
-    }, {
-        kind: string;
-        data?: unknown;
-    }>>;
-    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        type: z.ZodEnum<["error", "warning"]>;
-        message: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        type: "error" | "warning";
-        message: string;
-    }, {
-        type: "error" | "warning";
-        message: string;
-    }>, "many">>;
-    trace: z.ZodOptional<z.ZodObject<{
-        input: z.ZodString;
-        proposed: z.ZodString;
-        validated: z.ZodBoolean;
-        executed: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        input: string;
-        proposed: string;
-        validated: boolean;
-        executed?: string | undefined;
-    }, {
-        input: string;
-        proposed: string;
-        validated: boolean;
-        executed?: string | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    status: "error" | "ok";
-    rendered: string;
-    renderedErr?: string | undefined;
-    model?: {
-        kind: string;
-        data?: unknown;
-    } | undefined;
-    errors?: {
-        type: "error" | "warning";
-        message: string;
-    }[] | undefined;
-    trace?: {
-        input: string;
-        proposed: string;
-        validated: boolean;
-        executed?: string | undefined;
-    } | undefined;
-}, {
-    status: "error" | "ok";
-    rendered: string;
-    renderedErr?: string | undefined;
-    model?: {
-        kind: string;
-        data?: unknown;
-    } | undefined;
-    errors?: {
-        type: "error" | "warning";
-        message: string;
-    }[] | undefined;
-    trace?: {
-        input: string;
-        proposed: string;
-        validated: boolean;
-        executed?: string | undefined;
-    } | undefined;
-}>;
-/** The envelope type inferred from the wire schema. */
-export type WireEnvelope = z.infer<typeof commandEnvelopeSchema>;

package/dist/protocol/envelope.js

@@ -1,46 +0,0 @@
-/**
- * @file The wire schema for a command envelope.
- *
- * cumin defines the `CommandEnvelope` type (the shape produced in-stack);
- * calypso owns the wire schema that validates that envelope at the boundary
- * — the published promise an external surface programs against. The two are
- * kept in step by a compile-time check below: if cumin's type gains a field
- * the wire schema does not cover, this file stops compiling, so the contract
- * can never silently drift from what the code produces.
- *
- * @module
- */
-import { z } from 'zod';
-/** Terminal status of a completed command. */
-export const envelopeStatusSchema = z.enum(['ok', 'error']);
-/** A single structured error/warning drained from the error stack. */
-export const stackMessageSchema = z.object({
-    type: z.enum(['error', 'warning']),
-    message: z.string(),
-});
-/** A command's typed result: a namespaced kind and an opaque payload. */
-export const envelopeModelSchema = z.object({
-    kind: z.string(),
-    data: z.unknown(),
-});
-/** The record of how a natural-language input resolved into a command. */
-export const resolutionTraceSchema = z.object({
-    input: z.string(),
-    proposed: z.string(),
-    validated: z.boolean(),
-    executed: z.string().optional(),
-});
-/**
- * The envelope in which one command's complete outcome crosses the wire.
- */
-export const commandEnvelopeSchema = z.object({
-    status: envelopeStatusSchema,
-    rendered: z.string(),
-    renderedErr: z.string().optional(),
-    model: envelopeModelSchema.optional(),
-    errors: z.array(stackMessageSchema).optional(),
-    trace: resolutionTraceSchema.optional(),
-});
-const _envelopeCoversCumin = true;
-void _envelopeCoversCumin;
-//# sourceMappingURL=envelope.js.map

package/dist/protocol/envelope.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/protocol/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,8CAA8C;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AAE5D,sEAAsE;AACtE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,yEAAyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;CAClB,CAAC,CAAC;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,oBAAoB;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IACrC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE;IAC9C,KAAK,EAAE,qBAAqB,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAcH,MAAM,oBAAoB,GAAwB,IAAI,CAAC;AACvD,KAAK,oBAAoB,CAAC"}

package/dist/protocol/index.d.ts

@@ -1,16 +0,0 @@
-/**
- * @file The browser-safe protocol surface of the wire contract.
- *
- * This barrel exports only the protocol subtree: message schemas, envelope
- * schema, boundary validation, and the contract version. Nothing here touches
- * `ws`, Node builtins, or the daemon host, so a browser surface (argus) can
- * import the published contract through the `@fnndsc/calypso/protocol`
- * subpath without dragging server-side dependencies into its bundle. The main
- * package index remains the daemon-side entry point.
- *
- * @module
- */
-export { CONTRACT_VERSION, version_isCompatible } from './version.js';
-export { commandEnvelopeSchema, envelopeModelSchema, envelopeStatusSchema, stackMessageSchema, resolutionTraceSchema, type WireEnvelope, } from './envelope.js';
-export { attachMessageSchema, executeMessageSchema, completeRequestSchema, cancelMessageSchema, clientMessageSchema, serverMessageSchema, attachedMessageSchema, resultMessageSchema, sessionMessageSchema, outputMessageSchema, progressMessageSchema, promptLineMessageSchema, promptContextSchema, errorMessageSchema, type ClientMessage, type ServerMessage, type PromptContext, type ProgressEvent, } from './messages.js';
-export { clientMessage_parse, serverMessage_parse, attach_parse, type ParseResult, } from './validate.js';

package/dist/protocol/index.js

@@ -1,17 +0,0 @@
-/**
- * @file The browser-safe protocol surface of the wire contract.
- *
- * This barrel exports only the protocol subtree: message schemas, envelope
- * schema, boundary validation, and the contract version. Nothing here touches
- * `ws`, Node builtins, or the daemon host, so a browser surface (argus) can
- * import the published contract through the `@fnndsc/calypso/protocol`
- * subpath without dragging server-side dependencies into its bundle. The main
- * package index remains the daemon-side entry point.
- *
- * @module
- */
-export { CONTRACT_VERSION, version_isCompatible } from './version.js';
-export { commandEnvelopeSchema, envelopeModelSchema, envelopeStatusSchema, stackMessageSchema, resolutionTraceSchema, } from './envelope.js';
-export { attachMessageSchema, executeMessageSchema, completeRequestSchema, cancelMessageSchema, clientMessageSchema, serverMessageSchema, attachedMessageSchema, resultMessageSchema, sessionMessageSchema, outputMessageSchema, progressMessageSchema, promptLineMessageSchema, promptContextSchema, errorMessageSchema, } from './messages.js';
-export { clientMessage_parse, serverMessage_parse, attach_parse, } from './validate.js';
-//# sourceMappingURL=index.js.map

package/dist/protocol/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,GAEtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,GAKnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,GAEb,MAAM,eAAe,CAAC"}