@antigma/ante-remote-protocol 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,176 @@
+export type PeerRole = "host" | "browser";
+export type PermissionMode = "default" | "acceptEdits" | "bypassPermissions" | "plan" | "dontAsk" | "auto";
+export type ApprovalDecision = "Accept" | "AcceptForSession" | "Skip" | "Abort";
+export interface MachineIdentity {
+    machineId: string;
+    machineName: string;
+    token?: string;
+}
+export interface MachineStatus {
+    machineId: string;
+    machineName?: string;
+    online: boolean;
+    anteReady?: boolean;
+    activeSessionId?: string | null;
+    lastSeenAt: string;
+    capabilities?: string[];
+    runtimeTarget?: {
+        provider: string;
+        model: string;
+        source: "ante-defaults" | "env" | "fallback";
+    };
+    error?: string;
+}
+export interface LinkCodeRequest {
+    machineName?: string;
+    machineId?: string;
+}
+export interface LinkCodeResponse {
+    machineId: string;
+    token: string;
+    pairingCode: string;
+    serverUrl: string;
+    expiresAt: string;
+    expiresInSeconds: number;
+    hostPath: string;
+    hostWsUrl: string;
+    browserPath: string;
+    browserWsUrl: string;
+    hostCommand: string;
+}
+export interface SessionOptions {
+    cwd?: string;
+    provider?: string;
+    model?: string;
+    permissionMode?: PermissionMode;
+    resumeSessionId?: string;
+}
+export interface ConversationRoute {
+    clientConversationId?: string;
+}
+export interface ApprovalTool {
+    id: string;
+    name: string;
+    argsText?: string;
+}
+export interface ApprovalRequest {
+    turnId: string;
+    message: string;
+    tools: ApprovalTool[];
+}
+export interface RemoteEnvelope<TPayload = unknown> {
+    id: string;
+    type: string;
+    createdAt: string;
+    payload: TPayload;
+}
+export type HostHello = RemoteEnvelope<MachineIdentity & {
+    capabilities: string[];
+}> & {
+    type: "host.hello";
+};
+export type BrowserHello = RemoteEnvelope<{
+    machineId: string;
+    token?: string;
+}> & {
+    type: "browser.hello";
+};
+export type BrowserCommand = (RemoteEnvelope<{
+    options?: SessionOptions;
+}> & {
+    type: "session.start";
+}) | (RemoteEnvelope<{
+    sessionId?: string;
+    text: string;
+    options?: SessionOptions;
+} & ConversationRoute> & {
+    type: "user.message";
+}) | (RemoteEnvelope<{
+    sessionId?: string;
+    approval: ApprovalRequest;
+    decision: ApprovalDecision;
+} & ConversationRoute> & {
+    type: "approval.reply";
+}) | (RemoteEnvelope<{
+    sessionId?: string;
+} & ConversationRoute> & {
+    type: "session.interrupt";
+}) | (RemoteEnvelope<Record<string, never>> & {
+    type: "session.reset";
+}) | (RemoteEnvelope<Record<string, never>> & {
+    type: "browser.ping";
+});
+export type HostEvent = (RemoteEnvelope<MachineStatus> & {
+    type: "machine.status";
+}) | (RemoteEnvelope<{
+    sessionId: string;
+    cwd?: string;
+    provider?: string;
+    model?: string;
+} & ConversationRoute> & {
+    type: "session.started";
+}) | (RemoteEnvelope<{
+    sessionId?: string;
+    text: string;
+    kind: "answer" | "thinking";
+} & ConversationRoute> & {
+    type: "assistant.delta";
+}) | (RemoteEnvelope<{
+    sessionId?: string;
+    text: string;
+} & ConversationRoute> & {
+    type: "assistant.message";
+}) | (RemoteEnvelope<{
+    sessionId?: string;
+    approval: ApprovalRequest;
+} & ConversationRoute> & {
+    type: "approval.required";
+}) | (RemoteEnvelope<{
+    sessionId?: string;
+    tool: unknown;
+    phase: "start" | "end";
+} & ConversationRoute> & {
+    type: "tool.event";
+}) | (RemoteEnvelope<{
+    sessionId?: string;
+    status: "completed" | "failed" | "cancelled";
+    error?: string;
+} & ConversationRoute> & {
+    type: "session.done";
+}) | (RemoteEnvelope<{
+    sessionId?: string;
+    stream: "stdout" | "stderr" | "system";
+    text: string;
+} & ConversationRoute> & {
+    type: "diagnostic";
+}) | (RemoteEnvelope<{
+    message: string;
+}> & {
+    type: "host.error";
+}) | (RemoteEnvelope<Record<string, never>> & {
+    type: "host.pong";
+});
+export type RelayNotice = (RemoteEnvelope<MachineStatus> & {
+    type: "relay.machine";
+}) | (RemoteEnvelope<{
+    message: string;
+}> & {
+    type: "relay.error";
+}) | (RemoteEnvelope<{
+    token: string;
+}> & {
+    type: "relay.auth";
+}) | (RemoteEnvelope<{
+    role: PeerRole;
+    peerCount: number;
+}> & {
+    type: "relay.presence";
+});
+export type RemoteMessage = HostHello | BrowserHello | BrowserCommand | HostEvent | RelayNotice;
+export declare function createEnvelope<TPayload>(type: string, payload: TPayload): RemoteEnvelope<TPayload>;
+export declare function encodeMessage(message: RemoteMessage): string;
+export declare function decodeMessage(input: string | ArrayBuffer): RemoteMessage | null;
+export declare function isBrowserCommand(message: RemoteMessage): message is BrowserCommand;
+export declare function isHostEvent(message: RemoteMessage): message is HostEvent;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,59 @@
+export function createEnvelope(type, payload) {
+    return {
+        id: cryptoRandomId(),
+        type,
+        createdAt: new Date().toISOString(),
+        payload,
+    };
+}
+export function encodeMessage(message) {
+    return JSON.stringify(message);
+}
+export function decodeMessage(input) {
+    const text = typeof input === "string" ? input : new TextDecoder().decode(input);
+    try {
+        const value = JSON.parse(text);
+        if (!isRecord(value) || typeof value.type !== "string" || !isRecord(value.payload)) {
+            return null;
+        }
+        return value;
+    }
+    catch {
+        return null;
+    }
+}
+export function isBrowserCommand(message) {
+    return [
+        "session.start",
+        "user.message",
+        "approval.reply",
+        "session.interrupt",
+        "session.reset",
+        "browser.ping",
+    ].includes(message.type);
+}
+export function isHostEvent(message) {
+    return [
+        "machine.status",
+        "session.started",
+        "assistant.delta",
+        "assistant.message",
+        "approval.required",
+        "tool.event",
+        "session.done",
+        "diagnostic",
+        "host.error",
+        "host.pong",
+    ].includes(message.type);
+}
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function cryptoRandomId() {
+    const globalCrypto = globalThis.crypto;
+    if (globalCrypto && "randomUUID" in globalCrypto) {
+        return globalCrypto.randomUUID();
+    }
+    return `msg_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwIA,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,OAAiB;IAEjB,OAAO;QACL,EAAE,EAAE,cAAc,EAAE;QACpB,IAAI;QACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAsB;IAClD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAA2B;IACvD,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjF,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACnF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAiC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAsB;IACrD,OAAO;QACL,eAAe;QACf,cAAc;QACd,gBAAgB;QAChB,mBAAmB;QACnB,eAAe;QACf,cAAc;KACf,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAsB;IAChD,OAAO;QACL,gBAAgB;QAChB,iBAAiB;QACjB,iBAAiB;QACjB,mBAAmB;QACnB,mBAAmB;QACnB,YAAY;QACZ,cAAc;QACd,YAAY;QACZ,YAAY;QACZ,WAAW;KACZ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC;IACvC,IAAI,YAAY,IAAI,YAAY,IAAI,YAAY,EAAE,CAAC;QACjD,OAAO,YAAY,CAAC,UAAU,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACrF,CAAC"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@antigma/ante-remote-protocol",
+  "version": "0.1.0",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}