@maiaos/protocol 0.1.0-canary.1

package/dist/voice/relay-effect-schema.js

@@ -0,0 +1,89 @@
+import * as Schema from "effect/Schema";
+import { commandReceiptEffectSchema } from "../command-receipt/effect-schema.js";
+import { aggregateRevisionEffectSchema, protocolIdentifierEffectSchema, recordedAtEffectSchema, } from "../envelope/effect-schema.js";
+import { MAX_VOICE_PI_RELAY_BODY_BYTES } from "./policy.js";
+import { VOICE_SCHEMA_VERSION } from "./version.js";
+const utf8 = new TextEncoder();
+const persistedRevisionEffectSchema = aggregateRevisionEffectSchema.check(Schema.isPattern(/^[1-9]\d*$/u));
+const relayBodyEffectSchema = Schema.String.check(Schema.isBetweenLength(1, MAX_VOICE_PI_RELAY_BODY_BYTES), Schema.isPattern(/^[^\0]*$/u), Schema.makeFilter((value) => value.trim().length > 0 &&
+    utf8.encode(value).byteLength <= MAX_VOICE_PI_RELAY_BODY_BYTES, { expected: "non-empty, non-NUL text encoded within 4096 UTF-8 bytes" }));
+const relayProofEffectSchema = Schema.String.check(Schema.isBetweenLength(43, 43), Schema.isPattern(/^[A-Za-z0-9_-]{43}$/u));
+const relayTimestampEffectSchema = recordedAtEffectSchema;
+const relayIntentFields = {
+    body: relayBodyEffectSchema,
+    commandId: protocolIdentifierEffectSchema,
+    expectedContextRevision: persistedRevisionEffectSchema,
+    expectedWorkspaceRevision: persistedRevisionEffectSchema,
+    workspaceId: protocolIdentifierEffectSchema,
+};
+export const voicePiRelayPreviewParametersEffectSchema = Schema.Struct(relayIntentFields);
+export const voicePiRelayParametersEffectSchema = Schema.Struct({
+    ...relayIntentFields,
+    proof: relayProofEffectSchema,
+    sessionId: protocolIdentifierEffectSchema,
+});
+export const voicePiRelayReconcileParametersEffectSchema = Schema.Struct({
+    commandId: protocolIdentifierEffectSchema,
+});
+const relayAuthorityResultFields = {
+    commandId: protocolIdentifierEffectSchema,
+    contextRevision: persistedRevisionEffectSchema,
+    expiresAt: relayTimestampEffectSchema,
+    releaseQualified: Schema.Literal(false),
+    schemaVersion: Schema.Literal(VOICE_SCHEMA_VERSION),
+    sessionId: protocolIdentifierEffectSchema,
+    workspaceId: protocolIdentifierEffectSchema,
+    workspaceRevision: persistedRevisionEffectSchema,
+};
+export const voicePiRelayPreviewResultEffectSchema = Schema.Struct({
+    ...relayAuthorityResultFields,
+    method: Schema.Literal("voice.pi.relay.preview"),
+    proof: relayProofEffectSchema,
+});
+export const voicePiRelayResultEffectSchema = Schema.Struct({
+    commandId: protocolIdentifierEffectSchema,
+    contextRevision: persistedRevisionEffectSchema,
+    delivery: Schema.Literals(["new", "duplicate"]),
+    method: Schema.Literal("voice.pi.relay"),
+    receipt: commandReceiptEffectSchema,
+    releaseQualified: Schema.Literal(false),
+    schemaVersion: Schema.Literal(VOICE_SCHEMA_VERSION),
+    sessionId: protocolIdentifierEffectSchema,
+    workspaceId: protocolIdentifierEffectSchema,
+    workspaceRevision: persistedRevisionEffectSchema,
+}).check(Schema.makeFilter((result) => result.receipt.commandId === result.commandId &&
+    result.receipt.method === result.method &&
+    result.receipt.target.id === result.sessionId &&
+    result.receipt.target.type === "session", { expected: "a voice Pi relay result matching its exact Session receipt" }));
+export const voicePiRelayReconcileResultEffectSchema = Schema.Struct({
+    ...relayAuthorityResultFields,
+    method: Schema.Literal("voice.pi.relay.reconcile"),
+    state: Schema.Literals([
+        "previewed",
+        "expired",
+        "prepared",
+        "dispatching",
+        "acknowledged",
+        "outcome-unknown",
+    ]),
+});
+export const voicePiRelayRequestPayloadEffectSchema = Schema.Union([
+    Schema.Struct({
+        method: Schema.Literal("voice.pi.relay.preview"),
+        parameters: voicePiRelayPreviewParametersEffectSchema,
+    }),
+    Schema.Struct({
+        method: Schema.Literal("voice.pi.relay"),
+        parameters: voicePiRelayParametersEffectSchema,
+    }),
+    Schema.Struct({
+        method: Schema.Literal("voice.pi.relay.reconcile"),
+        parameters: voicePiRelayReconcileParametersEffectSchema,
+    }),
+]);
+export const voicePiRelaySuccessResultEffectSchema = Schema.Union([
+    voicePiRelayPreviewResultEffectSchema,
+    voicePiRelayResultEffectSchema,
+    voicePiRelayReconcileResultEffectSchema,
+]);
+//# sourceMappingURL=relay-effect-schema.js.map

package/dist/voice/relay-effect-schema.js.map

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

package/dist/voice/version.d.ts

@@ -0,0 +1,7 @@
+export declare const VOICE_ORCHESTRATOR_CONTEXT_SCHEMA_VERSION = "maia.voice-orchestrator-context/v1";
+export declare const VOICE_ORCHESTRATOR_TOOL_CALL_RESULT_SCHEMA_VERSION = "maia.voice-orchestrator-call/v1";
+export declare const VOICE_ORCHESTRATOR_TOOL_RESULT_SCHEMA_VERSION = "maia.voice-tool-result/v1";
+export declare const VOICE_ORCHESTRATOR_TOOL_SCHEMA_VERSION = 1;
+export declare const VOICE_SCHEMA_VERSION = 2;
+export declare const VOICE_MANAGED_TURN_SCHEMA_VERSION = "maia.voice-managed-turn/v1";
+//# sourceMappingURL=version.d.ts.map

package/dist/voice/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/voice/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yCAAyC,uCAChB,CAAC;AACvC,eAAO,MAAM,kDAAkD,oCAC5B,CAAC;AACpC,eAAO,MAAM,6CAA6C,8BAC7B,CAAC;AAC9B,eAAO,MAAM,sCAAsC,IAAI,CAAC;AACxD,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,iCAAiC,+BAA+B,CAAC"}

package/dist/voice/version.js

@@ -0,0 +1,7 @@
+export const VOICE_ORCHESTRATOR_CONTEXT_SCHEMA_VERSION = "maia.voice-orchestrator-context/v1";
+export const VOICE_ORCHESTRATOR_TOOL_CALL_RESULT_SCHEMA_VERSION = "maia.voice-orchestrator-call/v1";
+export const VOICE_ORCHESTRATOR_TOOL_RESULT_SCHEMA_VERSION = "maia.voice-tool-result/v1";
+export const VOICE_ORCHESTRATOR_TOOL_SCHEMA_VERSION = 1;
+export const VOICE_SCHEMA_VERSION = 2;
+export const VOICE_MANAGED_TURN_SCHEMA_VERSION = "maia.voice-managed-turn/v1";
+//# sourceMappingURL=version.js.map

package/dist/voice/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/voice/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yCAAyC,GACpD,oCAAoC,CAAC;AACvC,MAAM,CAAC,MAAM,kDAAkD,GAC7D,iCAAiC,CAAC;AACpC,MAAM,CAAC,MAAM,6CAA6C,GACxD,2BAA2B,CAAC;AAC9B,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,iCAAiC,GAAG,4BAA4B,CAAC"}

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@maiaos/protocol",
+  "version": "0.1.0-canary.1",
+  "description": "Operation registry and Effect Schema contracts for Maia OS: operation IDs, envelopes, errors, receipts and MCP tool definitions for AI coding agents.",
+  "keywords": [
+    "maia",
+    "maiaos",
+    "ai-agents",
+    "coding-agents",
+    "multi-agent",
+    "agent-orchestration",
+    "protocol",
+    "schema",
+    "effect",
+    "effect-schema",
+    "mcp",
+    "typescript"
+  ],
+  "homepage": "https://github.com/maiaos/maiaos/tree/main/packages/protocol#readme",
+  "bugs": "https://github.com/maiaos/maiaos/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/maiaos/maiaos.git",
+    "directory": "packages/protocol"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./agent-definition": {
+      "types": "./dist/agent/definition.d.ts",
+      "import": "./dist/agent/definition.js",
+      "default": "./dist/agent/definition.js"
+    },
+    "./feature-registry": {
+      "types": "./dist/feature/index.d.ts",
+      "import": "./dist/feature/index.js",
+      "default": "./dist/feature/index.js"
+    },
+    "./node-profile": {
+      "types": "./dist/local-node/node-profile.d.ts",
+      "import": "./dist/local-node/node-profile.js",
+      "default": "./dist/local-node/node-profile.js"
+    },
+    "./voice-orchestrator": {
+      "types": "./dist/voice/orchestrator.d.ts",
+      "import": "./dist/voice/orchestrator.js",
+      "default": "./dist/voice/orchestrator.js"
+    },
+    "./voice-pi-relay": {
+      "types": "./dist/voice/pi-relay.d.ts",
+      "import": "./dist/voice/pi-relay.js",
+      "default": "./dist/voice/pi-relay.js"
+    },
+    "./execution-candidate": {
+      "types": "./dist/execution/candidate.d.ts",
+      "import": "./dist/execution/candidate.js",
+      "default": "./dist/execution/candidate.js"
+    },
+    "./invocation-context-candidate": {
+      "types": "./dist/invocation-context/candidate.d.ts",
+      "import": "./dist/invocation-context/candidate.js",
+      "default": "./dist/invocation-context/candidate.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": "24.22.1"
+  },
+  "devDependencies": {
+    "@types/node": "24.13.3",
+    "@typescript/native": "npm:typescript@7.0.2",
+    "@vitest/coverage-v8": "5.0.1",
+    "@vllnt/typescript": "2.0.0-canary.a1749e0",
+    "eslint": "9.39.5",
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "vite": "8.2.1",
+    "vitest": "5.0.1"
+  },
+  "dependencies": {
+    "effect": "4.0.0"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist',{force:true,recursive:true})\" && tsc --project tsconfig.build.json && node ../../scripts/quality/verify-protocol-public-declarations.mjs --package packages/protocol",
+    "lint": "eslint src --max-warnings 0",
+    "test": "vitest run --maxWorkers=2 src",
+    "typecheck": "tsc --project tsconfig.json --noEmit"
+  }
+}