@opencode-cockpit/protocol 0.1.4 → 0.2.0

package/types/paths.d.ts

@@ -0,0 +1,12 @@
+export interface CockpitPaths {
+    home: string;
+    socket: string;
+    pidFile: string;
+    lockFile: string;
+    logFile: string;
+}
+/**
+ * Filesystem layout shared by daemon and clients. Pure: creates nothing.
+ * Kept short because unix socket paths are limited to 104 bytes on macOS.
+ */
+export declare function resolvePaths(env?: Record<string, string | undefined>): CockpitPaths;

package/types/rpc.d.ts

@@ -0,0 +1,63 @@
+/** Wire envelope: JSON-RPC 2.0, one JSON object per line (ADR 0002). */
+/** Bump MAJOR on breaking changes to methods, events or framing. */
+export declare const PROTOCOL_VERSION: {
+    readonly major: 1;
+    readonly minor: 2;
+};
+export type RequestId = number | string;
+export interface RpcRequest {
+    jsonrpc: "2.0";
+    id: RequestId;
+    method: string;
+    params?: unknown;
+}
+export interface RpcNotification {
+    jsonrpc: "2.0";
+    method: string;
+    params?: unknown;
+}
+export interface RpcSuccess {
+    jsonrpc: "2.0";
+    id: RequestId;
+    result: unknown;
+}
+export interface RpcFailure {
+    jsonrpc: "2.0";
+    id: RequestId | null;
+    error: RpcErrorShape;
+}
+export type RpcMessage = RpcRequest | RpcNotification | RpcSuccess | RpcFailure;
+export interface RpcErrorShape {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export declare const ErrorCode: {
+    readonly ParseError: -32700;
+    readonly InvalidRequest: -32600;
+    readonly MethodNotFound: -32601;
+    readonly InvalidParams: -32602;
+    readonly InternalError: -32603;
+    readonly NotFound: -32001;
+    readonly InvalidState: -32002;
+    readonly ProtocolMismatch: -32003;
+    readonly SpawnFailed: -32004;
+    readonly ShuttingDown: -32005;
+};
+export type ErrorCodeValue = (typeof ErrorCode)[keyof typeof ErrorCode];
+export declare class RpcError extends Error {
+    readonly code: number;
+    readonly data?: unknown;
+    constructor(code: number, message: string, data?: unknown);
+    toShape(): RpcErrorShape;
+    static from(shape: RpcErrorShape): RpcError;
+}
+/** Method name for daemon → client notifications. */
+export declare const EVENT_METHOD = "event";
+export interface EventEnvelope<T extends string = string, D = unknown> {
+    topic: T;
+    data: D;
+}
+export declare function isRequest(msg: RpcMessage): msg is RpcRequest;
+export declare function isNotification(msg: RpcMessage): msg is RpcNotification;
+export declare function isResponse(msg: RpcMessage): msg is RpcSuccess | RpcFailure;

package/types/shell/common.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+/** Identity and ownership, shared by every shell message. */
+export declare const ShellId: z.ZodString;
+export declare const Owner: z.ZodObject<{
+    project: z.ZodString;
+    session: z.ZodOptional<z.ZodString>;
+    instance: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ShellStatus: z.ZodEnum<{
+    exited: "exited";
+    failed: "failed";
+    killed: "killed";
+    running: "running";
+}>;
+export type Owner = z.output<typeof Owner>;
+export type ShellStatus = z.output<typeof ShellStatus>;