@maiaos/node 0.1.0-canary.44938d4.manual.1

package/dist/harness/pi-rpc/authorization/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/harness/pi-rpc/authorization/types.ts"],"names":[],"mappings":"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"}

package/dist/harness/pi-rpc/authorization/types.js

@@ -0,0 +1,3 @@
+export const PI_RPC_INTEGRATION = "pi-rpc";
+export const PI_RPC_OWNER_KINDS = ["pi-rpc-probe", "pi-rpc-session"];
+//# sourceMappingURL=types.js.map

package/dist/harness/pi-rpc/authorization/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/harness/pi-rpc/authorization/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,cAAc,EAAE,gBAAgB,CAAU,CAAC"}

package/dist/harness/pi-rpc/contract.d.ts

@@ -0,0 +1,86 @@
+import { type Effect, Schema, type Stream } from "effect";
+export declare const PI_RPC_NODE_VERSION = "24.19.0";
+export declare const PI_RPC_SESSION_PACKAGE_VERSION = "0.84.2";
+export declare const piRpcLimits: {
+    readonly exitDrainDeadline: "1 second";
+    readonly maximumInputRecordBytes: number;
+    readonly maximumMessageEndRecords: 16;
+    readonly maximumOutputRecordBytes: number;
+    readonly maximumOutputRecordsPerChunk: 4096;
+    readonly maximumOutstandingRequests: 8;
+    readonly maximumPendingInputBytes: number;
+    readonly maximumPendingInputRecords: 8;
+    readonly maximumPromptBytes: number;
+    readonly maximumRequestIdBytes: 128;
+    readonly maximumStderrBytes: number;
+    readonly maximumStdoutBytes: number;
+    readonly requestDeadline: "10 seconds";
+};
+declare const piRpcFailureReasonSchema: Schema.Literals<readonly ["command_rejected", "cleanup_unknown", "input_limit_exceeded", "invalid_request", "lifecycle_invalid", "output_limit_exceeded", "prompt_acceptance_unknown", "protocol_invalid", "request_outcome_unknown", "runtime_exited", "saturated", "transport_failed"]>;
+export type PiRpcFailureReason = typeof piRpcFailureReasonSchema.Type;
+declare const PiRpcFailure_base: Schema.Class<PiRpcFailure, Schema.TaggedStruct<"PiRpcFailure", {
+    readonly message: Schema.String;
+    readonly reason: Schema.Literals<readonly ["command_rejected", "cleanup_unknown", "input_limit_exceeded", "invalid_request", "lifecycle_invalid", "output_limit_exceeded", "prompt_acceptance_unknown", "protocol_invalid", "request_outcome_unknown", "runtime_exited", "saturated", "transport_failed"]>;
+}>, import("effect/Cause").YieldableError>;
+export declare class PiRpcFailure extends PiRpcFailure_base {
+}
+export declare const piRpcFailureSchema: typeof PiRpcFailure;
+export declare const piRpcFailure: (reason: PiRpcFailureReason, message: string) => PiRpcFailure;
+export type PiRpcArtifactIdentity = {
+    readonly entryPath: string;
+    readonly entrySha256: string;
+    readonly interpreterPath: string;
+    readonly interpreterSha256: string;
+    readonly interpreterVersion: string;
+    readonly packageClosureSha256: string;
+    readonly packageName: string;
+    readonly packageVersion: string;
+};
+export type PiRpcActivationRequest = {
+    readonly kind: "fresh";
+    readonly sessionFile?: string;
+    readonly sessionId: string;
+} | {
+    readonly kind: "resume";
+    readonly sessionFile: string;
+    readonly sessionId: string;
+};
+export type PiRpcLaunchInput = {
+    readonly activation: PiRpcActivationRequest;
+    readonly artifact: PiRpcArtifactIdentity;
+    readonly nodePrivateRoot: string;
+    readonly workingDirectory: string;
+};
+export type PiRpcLaunchPlan = {
+    readonly activation: PiRpcActivationRequest;
+    readonly agentDirectory: string;
+    readonly arguments_: readonly string[];
+    readonly artifact: PiRpcArtifactIdentity;
+    readonly environment: Readonly<NodeJS.ProcessEnv>;
+    readonly executable: string;
+    readonly homeDirectory: string;
+    readonly sessionDirectory: string;
+    readonly temporaryDirectory: string;
+    readonly workingDirectory: string;
+};
+/**
+ * Builds the fixed conversation-tier Pi invocation. Filesystem identity
+ * verification, launch permission, directory creation, and process start
+ * remain later composition work.
+ */
+export declare const buildPiRpcLaunchPlan: (input: PiRpcLaunchInput) => PiRpcLaunchPlan;
+export type PiRpcProcessExit = {
+    readonly code: null | number;
+    readonly signal: null | string;
+};
+export type PiRpcProcess = {
+    readonly exit: Effect.Effect<PiRpcProcessExit, PiRpcFailure>;
+    readonly shutdown: Effect.Effect<void, PiRpcFailure>;
+    readonly standardError: Stream.Stream<Uint8Array, PiRpcFailure>;
+    readonly standardInput: {
+        readonly write: (bytes: Uint8Array) => Effect.Effect<void, PiRpcFailure>;
+    };
+    readonly standardOutput: Stream.Stream<Uint8Array, PiRpcFailure>;
+};
+export {};
+//# sourceMappingURL=contract.d.ts.map

package/dist/harness/pi-rpc/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/harness/pi-rpc/contract.ts"],"names":[],"mappings":"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"}

package/dist/harness/pi-rpc/contract.js

@@ -0,0 +1,206 @@
+import { dirname, isAbsolute, join, normalize, relative, resolve, sep, } from "node:path";
+import { Schema } from "effect";
+export const PI_RPC_NODE_VERSION = "24.19.0";
+export const PI_RPC_SESSION_PACKAGE_VERSION = "0.84.2";
+export const piRpcLimits = {
+    exitDrainDeadline: "1 second",
+    maximumInputRecordBytes: 64 * 1024,
+    maximumMessageEndRecords: 16,
+    maximumOutputRecordBytes: 1024 * 1024,
+    maximumOutputRecordsPerChunk: 4096,
+    maximumOutstandingRequests: 8,
+    maximumPendingInputBytes: 128 * 1024,
+    maximumPendingInputRecords: 8,
+    maximumPromptBytes: 48 * 1024,
+    maximumRequestIdBytes: 128,
+    maximumStderrBytes: 64 * 1024,
+    maximumStdoutBytes: 16 * 1024 * 1024,
+    requestDeadline: "10 seconds",
+};
+const piRpcFailureReasonSchema = Schema.Literals([
+    "command_rejected",
+    "cleanup_unknown",
+    "input_limit_exceeded",
+    "invalid_request",
+    "lifecycle_invalid",
+    "output_limit_exceeded",
+    "prompt_acceptance_unknown",
+    "protocol_invalid",
+    "request_outcome_unknown",
+    "runtime_exited",
+    "saturated",
+    "transport_failed",
+]);
+const defineTaggedFailure = Schema.TaggedError;
+export class PiRpcFailure extends defineTaggedFailure("@maiaos/node/pi-rpc-failure")("PiRpcFailure", {
+    message: Schema.String,
+    reason: piRpcFailureReasonSchema,
+}) {
+}
+export const piRpcFailureSchema = PiRpcFailure;
+export const piRpcFailure = (reason, message) => new PiRpcFailure({ message, reason });
+const sessionIdPattern = /^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$/u;
+const packageNamePattern = /^(?:@[a-z0-9._-]+\/)?[a-z0-9._-]+$/u;
+const packageVersionPattern = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/u;
+const sha256Pattern = /^[0-9a-f]{64}$/u;
+const invalidLaunch = (message) => {
+    throw piRpcFailure("invalid_request", message);
+};
+const requireBoundedText = (value, label, maximumBytes) => {
+    if (value.length === 0 ||
+        value.includes("\0") ||
+        Buffer.byteLength(value, "utf8") > maximumBytes) {
+        return invalidLaunch(`The Pi RPC ${label} is invalid.`);
+    }
+    return value;
+};
+const requireAbsoluteNormalizedPath = (value, label) => {
+    requireBoundedText(value, label, 4096);
+    if (!isAbsolute(value) ||
+        normalize(value) !== value ||
+        resolve(value) !== value) {
+        return invalidLaunch(`The Pi RPC ${label} must be an absolute normalized path.`);
+    }
+    return value;
+};
+const requireDigest = (value, label) => {
+    if (!sha256Pattern.test(value)) {
+        return invalidLaunch(`The Pi RPC ${label} must be a lowercase SHA-256.`);
+    }
+    return value;
+};
+const requireSessionId = (value) => {
+    requireBoundedText(value, "session id", 128);
+    if (!sessionIdPattern.test(value)) {
+        return invalidLaunch("The Pi RPC session id is invalid.");
+    }
+    return value;
+};
+const isInside = (parent, child) => {
+    const childRelative = relative(parent, child);
+    return (childRelative.length > 0 &&
+        childRelative !== ".." &&
+        !childRelative.startsWith(`..${sep}`) &&
+        !isAbsolute(childRelative));
+};
+const validateArtifact = (artifact) => {
+    if (artifact.interpreterVersion !== PI_RPC_NODE_VERSION) {
+        return invalidLaunch(`Pi RPC requires the exact Node ${PI_RPC_NODE_VERSION} interpreter.`);
+    }
+    requireAbsoluteNormalizedPath(artifact.interpreterPath, "interpreter path");
+    requireAbsoluteNormalizedPath(artifact.entryPath, "entry path");
+    requireDigest(artifact.interpreterSha256, "interpreter digest");
+    requireDigest(artifact.entrySha256, "entry digest");
+    requireDigest(artifact.packageClosureSha256, "package-closure digest");
+    requireBoundedText(artifact.packageName, "package name", 214);
+    requireBoundedText(artifact.packageVersion, "package version", 128);
+    if (!packageNamePattern.test(artifact.packageName)) {
+        return invalidLaunch("The Pi RPC package name is invalid.");
+    }
+    if (!packageVersionPattern.test(artifact.packageVersion)) {
+        return invalidLaunch("The Pi RPC package version is invalid.");
+    }
+    return Object.freeze({ ...artifact });
+};
+const makeRuntimePaths = (nodePrivateRoot, sessionId) => {
+    const runtimeRoot = join(nodePrivateRoot, "harness", "pi-rpc", sessionId);
+    return {
+        agentDirectory: join(runtimeRoot, "agent"),
+        homeDirectory: join(runtimeRoot, "home"),
+        sessionDirectory: join(runtimeRoot, "sessions"),
+        temporaryDirectory: join(runtimeRoot, "tmp"),
+    };
+};
+const validateActivation = (activation, paths, sessionId) => {
+    if (activation.kind === "fresh" && activation.sessionFile === undefined) {
+        return { kind: "fresh", sessionId };
+    }
+    if (activation.sessionFile === undefined) {
+        return invalidLaunch("The Pi RPC session file is missing.");
+    }
+    const sessionFile = requireAbsoluteNormalizedPath(activation.sessionFile, activation.kind === "fresh"
+        ? "prepared fresh session file"
+        : "resume session file");
+    if (dirname(sessionFile) !== paths.sessionDirectory ||
+        !isInside(paths.sessionDirectory, sessionFile) ||
+        !sessionFile.endsWith(".jsonl")) {
+        invalidLaunch("The Pi RPC resume file must be an exact file in its node-private session directory.");
+    }
+    return { kind: activation.kind, sessionFile, sessionId };
+};
+const buildArguments = (artifact, activation, sessionDirectory) => {
+    let sessionArguments;
+    if (activation.kind === "fresh" && activation.sessionFile === undefined) {
+        sessionArguments = ["--session-id", activation.sessionId];
+    }
+    else if (activation.sessionFile === undefined) {
+        return invalidLaunch("The Pi RPC session file is missing.");
+    }
+    else {
+        sessionArguments = ["--session", activation.sessionFile];
+    }
+    return Object.freeze([
+        artifact.entryPath,
+        "--mode",
+        "rpc",
+        "--session-dir",
+        sessionDirectory,
+        ...sessionArguments,
+        "--no-tools",
+        "--no-extensions",
+        "--no-skills",
+        "--no-prompt-templates",
+        "--no-themes",
+        "--no-context-files",
+        "--no-approve",
+        "--offline",
+    ]);
+};
+const buildEnvironment = (paths) => Object.freeze({
+    ["HOME"]: paths.homeDirectory,
+    ["LANG"]: "C",
+    ["LC_ALL"]: "C",
+    ["NO_COLOR"]: "1",
+    ["PI_CODING_AGENT_DIR"]: paths.agentDirectory,
+    ["PI_CODING_AGENT_SESSION_DIR"]: paths.sessionDirectory,
+    ["PI_OFFLINE"]: "1",
+    ["PI_TELEMETRY"]: "0",
+    ["TMPDIR"]: paths.temporaryDirectory,
+});
+const prepareLaunchPaths = (input) => {
+    const nodePrivateRoot = requireAbsoluteNormalizedPath(input.nodePrivateRoot, "node-private root");
+    if (dirname(nodePrivateRoot) === nodePrivateRoot) {
+        invalidLaunch("The Pi RPC node-private root cannot be a filesystem root.");
+    }
+    const workingDirectory = requireAbsoluteNormalizedPath(input.workingDirectory, "working directory");
+    const sessionId = requireSessionId(input.activation.sessionId);
+    const paths = makeRuntimePaths(nodePrivateRoot, sessionId);
+    return {
+        activation: validateActivation(input.activation, paths, sessionId),
+        paths,
+        workingDirectory,
+    };
+};
+/**
+ * Builds the fixed conversation-tier Pi invocation. Filesystem identity
+ * verification, launch permission, directory creation, and process start
+ * remain later composition work.
+ */
+export const buildPiRpcLaunchPlan = (input) => {
+    const artifact = validateArtifact(input.artifact);
+    const { activation, paths, workingDirectory } = prepareLaunchPaths(input);
+    if (activation.sessionFile !== undefined &&
+        artifact.packageVersion !== PI_RPC_SESSION_PACKAGE_VERSION) {
+        invalidLaunch(`Pi RPC persistent sessions require the exact ${PI_RPC_SESSION_PACKAGE_VERSION} package format.`);
+    }
+    return Object.freeze({
+        activation,
+        ...paths,
+        arguments_: buildArguments(artifact, activation, paths.sessionDirectory),
+        artifact,
+        environment: buildEnvironment(paths),
+        executable: artifact.interpreterPath,
+        workingDirectory,
+    });
+};
+//# sourceMappingURL=contract.js.map

package/dist/harness/pi-rpc/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../src/harness/pi-rpc/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,UAAU,EACV,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,OAAO,EACP,GAAG,GACJ,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAe,MAAM,EAAe,MAAM,QAAQ,CAAC;AAE1D,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAC7C,MAAM,CAAC,MAAM,8BAA8B,GAAG,QAAQ,CAAC;AAEvD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,iBAAiB,EAAE,UAAU;IAC7B,uBAAuB,EAAE,EAAE,GAAG,IAAI;IAClC,wBAAwB,EAAE,EAAE;IAC5B,wBAAwB,EAAE,IAAI,GAAG,IAAI;IACrC,4BAA4B,EAAE,IAAI;IAClC,0BAA0B,EAAE,CAAC;IAC7B,wBAAwB,EAAE,GAAG,GAAG,IAAI;IACpC,0BAA0B,EAAE,CAAC;IAC7B,kBAAkB,EAAE,EAAE,GAAG,IAAI;IAC7B,qBAAqB,EAAE,GAAG;IAC1B,kBAAkB,EAAE,EAAE,GAAG,IAAI;IAC7B,kBAAkB,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;IACpC,eAAe,EAAE,YAAY;CACrB,CAAC;AAEX,MAAM,wBAAwB,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC/C,kBAAkB;IAClB,iBAAiB;IACjB,sBAAsB;IACtB,iBAAiB;IACjB,mBAAmB;IACnB,uBAAuB;IACvB,2BAA2B;IAC3B,kBAAkB;IAClB,yBAAyB;IACzB,gBAAgB;IAChB,WAAW;IACX,kBAAkB;CACnB,CAAC,CAAC;AAIH,MAAM,mBAAmB,GAAG,MAAM,CAAC,WAAW,CAAC;AAE/C,MAAM,OAAO,YAAa,SAAQ,mBAAmB,CACnD,6BAA6B,CAC9B,CAAC,cAAc,EAAE;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,MAAM,EAAE,wBAAwB;CACjC,CAAC;CAAG;AAEL,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAE/C,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAA0B,EAC1B,OAAe,EACD,EAAE,CAAC,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AA6CzD,MAAM,gBAAgB,GAAG,+CAA+C,CAAC;AACzE,MAAM,kBAAkB,GAAG,qCAAqC,CAAC;AACjE,MAAM,qBAAqB,GACzB,2DAA2D,CAAC;AAC9D,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAExC,MAAM,aAAa,GAAG,CAAC,OAAe,EAAS,EAAE;IAC/C,MAAM,YAAY,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CACzB,KAAa,EACb,KAAa,EACb,YAAoB,EACZ,EAAE;IACV,IACE,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpB,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,YAAY,EAC/C,CAAC;QACD,OAAO,aAAa,CAAC,cAAc,KAAK,cAAc,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,6BAA6B,GAAG,CACpC,KAAa,EACb,KAAa,EACL,EAAE;IACV,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACvC,IACE,CAAC,UAAU,CAAC,KAAK,CAAC;QAClB,SAAS,CAAC,KAAK,CAAC,KAAK,KAAK;QAC1B,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,EACxB,CAAC;QACD,OAAO,aAAa,CAClB,cAAc,KAAK,uCAAuC,CAC3D,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,KAAa,EAAU,EAAE;IAC7D,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,aAAa,CAAC,cAAc,KAAK,+BAA+B,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE;IACjD,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,aAAa,CAAC,mCAAmC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,KAAa,EAAW,EAAE;IAC1D,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO,CACL,aAAa,CAAC,MAAM,GAAG,CAAC;QACxB,aAAa,KAAK,IAAI;QACtB,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC;QACrC,CAAC,UAAU,CAAC,aAAa,CAAC,CAC3B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CACvB,QAA+B,EACR,EAAE;IACzB,IAAI,QAAQ,CAAC,kBAAkB,KAAK,mBAAmB,EAAE,CAAC;QACxD,OAAO,aAAa,CAClB,kCAAkC,mBAAmB,eAAe,CACrE,CAAC;IACJ,CAAC;IACD,6BAA6B,CAAC,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;IAC5E,6BAA6B,CAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAChE,aAAa,CAAC,QAAQ,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;IAChE,aAAa,CAAC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACpD,aAAa,CAAC,QAAQ,CAAC,oBAAoB,EAAE,wBAAwB,CAAC,CAAC;IACvE,kBAAkB,CAAC,QAAQ,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,CAAC,CAAC;IAC9D,kBAAkB,CAAC,QAAQ,CAAC,cAAc,EAAE,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACpE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACnD,OAAO,aAAa,CAAC,qCAAqC,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACzD,OAAO,aAAa,CAAC,wCAAwC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;AACxC,CAAC,CAAC;AAOF,MAAM,gBAAgB,GAAG,CACvB,eAAuB,EACvB,SAAiB,EACE,EAAE;IACrB,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC1E,OAAO;QACL,cAAc,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;QAC1C,aAAa,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;QACxC,gBAAgB,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;QAC/C,kBAAkB,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC;KAC7C,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CACzB,UAAkC,EAClC,KAAwB,EACxB,SAAiB,EACO,EAAE;IAC1B,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,IAAI,UAAU,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACxE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IACtC,CAAC;IACD,IAAI,UAAU,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACzC,OAAO,aAAa,CAAC,qCAAqC,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,WAAW,GAAG,6BAA6B,CAC/C,UAAU,CAAC,WAAW,EACtB,UAAU,CAAC,IAAI,KAAK,OAAO;QACzB,CAAC,CAAC,6BAA6B;QAC/B,CAAC,CAAC,qBAAqB,CAC1B,CAAC;IACF,IACE,OAAO,CAAC,WAAW,CAAC,KAAK,KAAK,CAAC,gBAAgB;QAC/C,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,EAAE,WAAW,CAAC;QAC9C,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAC/B,CAAC;QACD,aAAa,CACX,qFAAqF,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AAC3D,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CACrB,QAA+B,EAC/B,UAAkC,EAClC,gBAAwB,EACL,EAAE;IACrB,IAAI,gBAAmC,CAAC;IACxC,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,IAAI,UAAU,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACxE,gBAAgB,GAAG,CAAC,cAAc,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;SAAM,IAAI,UAAU,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAChD,OAAO,aAAa,CAAC,qCAAqC,CAAC,CAAC;IAC9D,CAAC;SAAM,CAAC;QACN,gBAAgB,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ,CAAC,SAAS;QAClB,QAAQ;QACR,KAAK;QACL,eAAe;QACf,gBAAgB;QAChB,GAAG,gBAAgB;QACnB,YAAY;QACZ,iBAAiB;QACjB,aAAa;QACb,uBAAuB;QACvB,aAAa;QACb,oBAAoB;QACpB,cAAc;QACd,WAAW;KACZ,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CACvB,KAAwB,EACK,EAAE,CAC/B,MAAM,CAAC,MAAM,CAAC;IACZ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,aAAa;IAC7B,CAAC,MAAM,CAAC,EAAE,GAAG;IACb,CAAC,QAAQ,CAAC,EAAE,GAAG;IACf,CAAC,UAAU,CAAC,EAAE,GAAG;IACjB,CAAC,qBAAqB,CAAC,EAAE,KAAK,CAAC,cAAc;IAC7C,CAAC,6BAA6B,CAAC,EAAE,KAAK,CAAC,gBAAgB;IACvD,CAAC,YAAY,CAAC,EAAE,GAAG;IACnB,CAAC,cAAc,CAAC,EAAE,GAAG;IACrB,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,kBAAkB;CACrC,CAAC,CAAC;AAEL,MAAM,kBAAkB,GAAG,CAAC,KAAuB,EAAE,EAAE;IACrD,MAAM,eAAe,GAAG,6BAA6B,CACnD,KAAK,CAAC,eAAe,EACrB,mBAAmB,CACpB,CAAC;IACF,IAAI,OAAO,CAAC,eAAe,CAAC,KAAK,eAAe,EAAE,CAAC;QACjD,aAAa,CAAC,2DAA2D,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,gBAAgB,GAAG,6BAA6B,CACpD,KAAK,CAAC,gBAAgB,EACtB,mBAAmB,CACpB,CAAC;IACF,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,gBAAgB,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IAC3D,OAAO;QACL,UAAU,EAAE,kBAAkB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,SAAS,CAAC;QAClE,KAAK;QACL,gBAAgB;KACjB,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,KAAuB,EACN,EAAE;IACnB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC1E,IACE,UAAU,CAAC,WAAW,KAAK,SAAS;QACpC,QAAQ,CAAC,cAAc,KAAK,8BAA8B,EAC1D,CAAC;QACD,aAAa,CACX,gDAAgD,8BAA8B,kBAAkB,CACjG,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,UAAU;QACV,GAAG,KAAK;QACR,UAAU,EAAE,cAAc,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,gBAAgB,CAAC;QACxE,QAAQ;QACR,WAAW,EAAE,gBAAgB,CAAC,KAAK,CAAC;QACpC,UAAU,EAAE,QAAQ,CAAC,eAAe;QACpC,gBAAgB;KACjB,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/harness/pi-rpc/conversation.d.ts

@@ -0,0 +1,129 @@
+import { Effect, Schema, type Scope } from "effect";
+import { type StateValue } from "xstate";
+import { PiRpcFailure, type PiRpcLaunchPlan, type PiRpcProcess, type PiRpcProcessExit } from "./contract.js";
+declare const assistantMessageSchema: Schema.StructWithRest<Schema.Struct<{
+    readonly role: Schema.Literal<"assistant">;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+declare const piRpcMessageSchema: Schema.Union<readonly [Schema.StructWithRest<Schema.Struct<{
+    readonly role: Schema.Literal<"user">;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>, Schema.StructWithRest<Schema.Struct<{
+    readonly role: Schema.Literal<"assistant">;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>, Schema.StructWithRest<Schema.Struct<{
+    readonly role: Schema.Literal<"toolResult">;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>]>;
+declare const sessionStateSchema: Schema.Struct<{
+    readonly autoCompactionEnabled: Schema.Boolean;
+    readonly followUpMode: Schema.Literals<readonly ["all", "one-at-a-time"]>;
+    readonly isCompacting: Schema.Boolean;
+    readonly isStreaming: Schema.Boolean;
+    readonly messageCount: Schema.Int;
+    readonly model: Schema.optional<Schema.Unknown>;
+    readonly pendingMessageCount: Schema.Int;
+    readonly sessionFile: Schema.optional<Schema.String>;
+    readonly sessionId: Schema.String;
+    readonly sessionName: Schema.optional<Schema.String>;
+    readonly steeringMode: Schema.Literals<readonly ["all", "one-at-a-time"]>;
+    readonly thinkingLevel: Schema.String;
+}>;
+export type PiRpcSessionState = typeof sessionStateSchema.Type;
+export type PiRpcMessage = typeof piRpcMessageSchema.Type;
+export type PiRpcAssistantMessage = typeof assistantMessageSchema.Type;
+export type PiRpcPromptLifecycleEvent = {
+    readonly type: "abortRequest";
+} | {
+    readonly type: "accept";
+} | {
+    readonly type: "fail";
+} | {
+    readonly type: "messageEnd";
+} | {
+    readonly type: "reject";
+} | {
+    readonly type: "settle";
+} | {
+    readonly type: "unknown";
+};
+export declare const piRpcPromptLifecycleMachine: import("xstate").StateMachine<{}, {
+    readonly type: "abortRequest";
+} | {
+    readonly type: "accept";
+} | {
+    readonly type: "fail";
+} | {
+    readonly type: "messageEnd";
+} | {
+    readonly type: "reject";
+} | {
+    readonly type: "settle";
+} | {
+    readonly type: "unknown";
+}, {}, never, never, never, never, "failed" | "settled" | "accepted" | "outcomeUnknown" | "awaitingAcceptance" | "aborting" | "messageEnded" | "rejected", string, import("xstate").NonReducibleUnknown, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
+    id: "maia-pi-rpc-prompt";
+    states: {
+        readonly aborting: {};
+        readonly accepted: {};
+        readonly awaitingAcceptance: {};
+        readonly failed: {};
+        readonly messageEnded: {};
+        readonly outcomeUnknown: {};
+        readonly rejected: {};
+        readonly settled: {};
+    };
+}>;
+export declare const describePiRpcPromptLifecycle: (value: StateValue) => "aborting" | "accepted" | "awaiting-acceptance" | "failed" | "message-ended" | "outcome-unknown" | "rejected" | "settled";
+export type PiRpcMessageEndObservation = {
+    readonly message: PiRpcAssistantMessage;
+    readonly state: "message_end";
+} | {
+    readonly state: "not_emitted_before_settlement";
+};
+export type PiRpcSettlement = {
+    readonly latestMessage?: PiRpcAssistantMessage;
+    readonly messageEndCount: number;
+    readonly messages: readonly PiRpcMessage[];
+    readonly state: "agent_settled";
+};
+export type PiRpcCleanupOutcome = {
+    readonly failure: PiRpcFailure;
+    readonly state: "cleanup_unknown";
+} | {
+    readonly state: "clean";
+};
+export type PiRpcPromptRun = {
+    readonly acceptance: "accepted";
+    readonly messageEnd: Effect.Effect<PiRpcMessageEndObservation, PiRpcFailure>;
+    readonly requestId: string;
+    readonly settled: Effect.Effect<PiRpcSettlement, PiRpcFailure>;
+};
+export type PiRpcAbortAcknowledgement = {
+    readonly acknowledged: true;
+    readonly requestId: string;
+    readonly settlement: Effect.Effect<PiRpcSettlement, PiRpcFailure>;
+};
+export type PiRpcActivationObservation = {
+    readonly kind: PiRpcLaunchPlan["activation"]["kind"];
+    readonly promptReplay: "never";
+    readonly sessionFile: string;
+    readonly sessionId: string;
+};
+export type PiRpcConversation = {
+    readonly abort: (input: {
+        readonly requestId: string;
+    }) => Effect.Effect<PiRpcAbortAcknowledgement, PiRpcFailure>;
+    readonly activation: PiRpcActivationObservation;
+    readonly cleanup: Effect.Effect<PiRpcCleanupOutcome>;
+    readonly failure: Effect.Effect<never, PiRpcFailure>;
+    readonly getState: Effect.Effect<PiRpcSessionState, PiRpcFailure>;
+    readonly processExit: Effect.Effect<PiRpcProcessExit, PiRpcFailure>;
+    readonly prompt: (input: {
+        readonly message: string;
+        readonly requestId: string;
+    }) => Effect.Effect<PiRpcPromptRun, PiRpcFailure>;
+};
+/**
+ * Attaches the protocol core to an already-authorized process. It performs no
+ * launch, artifact verification, filesystem creation, or public composition.
+ */
+export declare const acquirePiRpcConversation: (process_: PiRpcProcess, plan: PiRpcLaunchPlan) => Effect.Effect<PiRpcConversation, PiRpcFailure, Scope.Scope>;
+export {};
+//# sourceMappingURL=conversation.d.ts.map

package/dist/harness/pi-rpc/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../../src/harness/pi-rpc/conversation.ts"],"names":[],"mappings":"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"}