@kraki/protocol 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kraki Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/channels.d.ts

@@ -0,0 +1,7 @@
+export interface Channel {
+    id: string;
+    ownerId: string;
+    name?: string;
+    createdAt: string;
+}
+//# sourceMappingURL=channels.d.ts.map

package/dist/channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../src/channels.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/channels.js

@@ -0,0 +1,5 @@
+// ------------------------------------------------------------
+// Channel types
+// ------------------------------------------------------------
+export {};
+//# sourceMappingURL=channels.js.map

package/dist/channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../src/channels.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gBAAgB;AAChB,+DAA+D"}

package/dist/devices.d.ts

@@ -0,0 +1,43 @@
+export type DeviceRole = 'tentacle' | 'app';
+export type DeviceKind = 'desktop' | 'server' | 'vm' | 'web' | 'ios' | 'android';
+export interface Device {
+    id: string;
+    channelId: string;
+    name: string;
+    role: DeviceRole;
+    kind?: DeviceKind;
+    publicKey?: string;
+    lastSeen: string;
+    createdAt: string;
+}
+export interface DeviceSummary {
+    id: string;
+    name: string;
+    role: DeviceRole;
+    kind?: DeviceKind;
+    /** Public key for auth (RSASSA-PKCS1-v1_5) */
+    publicKey?: string;
+    /** Public key for E2E encryption (RSA-OAEP). If absent, use publicKey. */
+    encryptionKey?: string;
+    online: boolean;
+    /** Capabilities reported by the device (e.g. available models) */
+    capabilities?: DeviceCapabilities;
+}
+export interface DeviceInfo {
+    name: string;
+    role: DeviceRole;
+    kind?: DeviceKind;
+    /** Public key for challenge-response auth (RSASSA-PKCS1-v1_5, SPKI base64) */
+    publicKey?: string;
+    /** Public key for E2E encryption (RSA-OAEP, SPKI base64). If omitted, publicKey is used. */
+    encryptionKey?: string;
+    /** Client-provided stable device ID for reconnection. If omitted, server generates one. */
+    deviceId?: string;
+    /** Capabilities reported by the device */
+    capabilities?: DeviceCapabilities;
+}
+export interface DeviceCapabilities {
+    /** Available agent models (e.g. ["claude-sonnet-4", "gpt-4.1"]) */
+    models?: string[];
+}
+//# sourceMappingURL=devices.d.ts.map

package/dist/devices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.d.ts","sourceRoot":"","sources":["../src/devices.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,KAAK,CAAC;AAC5C,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;AAEjF,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/devices.js

@@ -0,0 +1,5 @@
+// ------------------------------------------------------------
+// Device types
+// ------------------------------------------------------------
+export {};
+//# sourceMappingURL=devices.js.map

package/dist/devices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.js","sourceRoot":"","sources":["../src/devices.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,eAAe;AACf,+DAA+D"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './messages.js';
+export * from './channels.js';
+export * from './devices.js';
+export * from './sessions.js';
+export * from './tools.js';
+//# 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":"AAOA,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+// ============================================================
+// Kraki Protocol — The shared contract
+// ============================================================
+// All packages (head, tentacle, app) import from here.
+// Change types here = change everywhere.
+// ============================================================
+export * from './messages.js';
+export * from './channels.js';
+export * from './devices.js';
+export * from './sessions.js';
+export * from './tools.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,uCAAuC;AACvC,+DAA+D;AAC/D,uDAAuD;AACvD,yCAAyC;AACzC,+DAA+D;AAE/D,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,313 @@
+interface BaseEnvelope {
+    channel: string;
+    deviceId: string;
+    seq: number;
+    timestamp: string;
+    sessionId?: string;
+}
+export interface SessionCreatedMessage extends BaseEnvelope {
+    type: 'session_created';
+    payload: {
+        agent: string;
+        model?: string;
+        /** Echoed from create_session for request tracking */
+        requestId?: string;
+    };
+}
+export interface SessionEndedMessage extends BaseEnvelope {
+    type: 'session_ended';
+    payload: {
+        reason: string;
+    };
+}
+export interface UserMessage extends BaseEnvelope {
+    type: 'user_message';
+    payload: {
+        content: string;
+    };
+}
+export interface AgentMessage extends BaseEnvelope {
+    type: 'agent_message';
+    payload: {
+        content: string;
+        attachments?: string[];
+    };
+}
+export interface AgentMessageDelta extends BaseEnvelope {
+    type: 'agent_message_delta';
+    payload: {
+        content: string;
+    };
+}
+export interface PermissionRequest extends BaseEnvelope {
+    type: 'permission';
+    payload: ToolArgs & {
+        id: string;
+        description: string;
+    };
+}
+export interface QuestionRequest extends BaseEnvelope {
+    type: 'question';
+    payload: {
+        id: string;
+        question: string;
+        choices?: string[];
+    };
+}
+export interface ToolStartMessage extends BaseEnvelope {
+    type: 'tool_start';
+    payload: ToolArgs & {
+        /** Unique ID for this tool invocation (matches tool_complete) */
+        toolCallId?: string;
+    };
+}
+export interface ToolCompleteMessage extends BaseEnvelope {
+    type: 'tool_complete';
+    payload: ToolArgs & {
+        result: string;
+        /** Unique ID matching the tool_start */
+        toolCallId?: string;
+    };
+}
+export interface IdleMessage extends BaseEnvelope {
+    type: 'idle';
+    payload: Record<string, never>;
+}
+export interface ErrorMessage extends BaseEnvelope {
+    type: 'error';
+    payload: {
+        message: string;
+    };
+}
+export interface SessionModeSetMessage extends BaseEnvelope {
+    type: 'session_mode_set';
+    payload: {
+        mode: 'ask' | 'auto';
+    };
+}
+export type ProducerMessage = SessionCreatedMessage | SessionEndedMessage | UserMessage | AgentMessage | AgentMessageDelta | PermissionRequest | QuestionRequest | ToolStartMessage | ToolCompleteMessage | IdleMessage | ErrorMessage | SessionModeSetMessage;
+/** Message types the head persists for session recovery */
+export type StoredMessageType = 'session_created' | 'session_ended' | 'user_message' | 'agent_message' | 'permission' | 'question' | 'tool_start' | 'tool_complete' | 'error' | 'send_input' | 'approve' | 'deny' | 'always_allow' | 'answer' | 'kill_session' | 'session_mode_set';
+/** Message types forwarded in real-time only (not persisted) */
+export type TransientMessageType = 'agent_message_delta' | 'idle' | 'create_session';
+export interface SendInputMessage extends BaseEnvelope {
+    type: 'send_input';
+    payload: {
+        text: string;
+        attachments?: string[];
+    };
+}
+export interface ApproveMessage extends BaseEnvelope {
+    type: 'approve';
+    payload: {
+        permissionId: string;
+    };
+}
+export interface DenyMessage extends BaseEnvelope {
+    type: 'deny';
+    payload: {
+        permissionId: string;
+    };
+}
+export interface AlwaysAllowMessage extends BaseEnvelope {
+    type: 'always_allow';
+    payload: {
+        permissionId: string;
+        /** Tool kind to add to the allow list (e.g. 'shell', 'write') */
+        toolKind?: string;
+    };
+}
+export interface AnswerMessage extends BaseEnvelope {
+    type: 'answer';
+    payload: {
+        questionId: string;
+        answer: string;
+    };
+}
+export interface KillSessionMessage extends BaseEnvelope {
+    type: 'kill_session';
+    payload: Record<string, never>;
+}
+export interface AbortSessionMessage extends BaseEnvelope {
+    type: 'abort_session';
+    payload: Record<string, never>;
+}
+export interface CreateSessionMessage extends BaseEnvelope {
+    type: 'create_session';
+    payload: {
+        /** Client-generated request ID for tracking success/failure */
+        requestId: string;
+        /** Target tentacle device ID */
+        targetDeviceId: string;
+        /** Agent model to use (e.g. "claude-sonnet-4") */
+        model: string;
+        /** Initial prompt to send after session is created */
+        prompt?: string;
+        /** Working directory for the session */
+        cwd?: string;
+    };
+}
+export interface SetSessionModeMessage extends BaseEnvelope {
+    type: 'set_session_mode';
+    payload: {
+        mode: 'ask' | 'auto';
+    };
+}
+export type ConsumerMessage = SendInputMessage | ApproveMessage | DenyMessage | AlwaysAllowMessage | AnswerMessage | KillSessionMessage | AbortSessionMessage | CreateSessionMessage | SetSessionModeMessage;
+export interface AuthMessage {
+    type: 'auth';
+    token?: string;
+    channelKey?: string;
+    /** One-time pairing token from QR code (alternative to token/channelKey) */
+    pairingToken?: string;
+    /** GitHub OAuth authorization code (exchanged server-side for access token) */
+    githubCode?: string;
+    device: DeviceInfo;
+}
+export interface AuthOkMessage {
+    type: 'auth_ok';
+    channel: string;
+    deviceId: string;
+    e2e: boolean;
+    devices: DeviceSummary[];
+    sessions: SessionSummary[];
+    /** Per-session last-read seq for this device (for unread tracking) */
+    readState?: Record<string, number>;
+    /** Channel owner identity (login, provider) for profile display */
+    user?: {
+        id: string;
+        login: string;
+        provider: string;
+        email?: string;
+    };
+}
+export interface AuthErrorMessage {
+    type: 'auth_error';
+    message: string;
+}
+export interface AuthChallengeMessage {
+    type: 'auth_challenge';
+    nonce: string;
+}
+export interface AuthResponseMessage {
+    type: 'auth_response';
+    deviceId: string;
+    signature: string;
+}
+export interface ServerErrorMessage {
+    type: 'server_error';
+    message: string;
+    /** Echoed from create_session for request tracking */
+    requestId?: string;
+}
+export interface ReplayMessage {
+    type: 'replay';
+    afterSeq: number;
+    sessionId?: string;
+}
+export interface MarkReadMessage {
+    type: 'mark_read';
+    sessionId: string;
+    /** The highest seq the client has seen for this session */
+    seq: number;
+}
+export interface CreatePairingTokenMessage {
+    type: 'create_pairing_token';
+}
+/** One-shot pairing token request — no device registration needed */
+export interface RequestPairingTokenMessage {
+    type: 'request_pairing_token';
+    /** Auth token (e.g. GitHub token) to prove identity */
+    token: string;
+}
+export interface PairingTokenCreatedMessage {
+    type: 'pairing_token_created';
+    token: string;
+    expiresIn: number;
+}
+export interface PingMessage {
+    type: 'ping';
+}
+export interface PongMessage {
+    type: 'pong';
+}
+/** Pre-auth request to discover server capabilities. */
+export interface AuthInfoRequest {
+    type: 'auth_info';
+}
+/** Server response with supported auth modes and features. */
+export interface AuthInfoResponse {
+    type: 'auth_info_response';
+    /** Supported auth modes (e.g. ['github', 'apikey', 'open']) */
+    authModes: string[];
+    /** Whether E2E encryption is enabled */
+    e2e: boolean;
+    /** Whether device pairing is enabled */
+    pairing: boolean;
+    /** GitHub OAuth client ID (present when GitHub OAuth is configured for web login) */
+    githubClientId?: string;
+}
+/** Global notification from head to all connected devices (tentacles + apps) */
+export type HeadNotice = {
+    type: 'head_notice';
+    event: 'device_online';
+    data: {
+        device: DeviceSummary;
+    };
+} | {
+    type: 'head_notice';
+    event: 'device_offline';
+    data: {
+        deviceId: string;
+    };
+} | {
+    type: 'head_notice';
+    event: 'device_added';
+    data: {
+        device: DeviceSummary;
+    };
+} | {
+    type: 'head_notice';
+    event: 'device_removed';
+    data: {
+        deviceId: string;
+    };
+} | {
+    type: 'head_notice';
+    event: 'session_updated';
+    data: {
+        session: SessionSummary;
+    };
+} | {
+    type: 'head_notice';
+    event: 'update_allow_list';
+    data: {
+        allowedTools: string[];
+    };
+};
+export type ControlMessage = AuthMessage | AuthOkMessage | AuthErrorMessage | AuthChallengeMessage | AuthResponseMessage | ServerErrorMessage | ReplayMessage | MarkReadMessage | CreatePairingTokenMessage | RequestPairingTokenMessage | PairingTokenCreatedMessage | AuthInfoRequest | AuthInfoResponse | PingMessage | PongMessage | HeadNotice;
+export interface EncryptedMessage extends BaseEnvelope {
+    type: 'encrypted';
+    /** AES-256-GCM initialization vector (base64) */
+    iv: string;
+    /** AES-256-GCM encrypted payload (base64) — same for all recipients */
+    ciphertext: string;
+    /** AES-256-GCM authentication tag (base64) — tamper detection */
+    tag: string;
+    /** Per-device RSA-OAEP encrypted AES key (base64) */
+    keys: Record<string, string>;
+    /** Agent name exposed from session_created for head session registration */
+    agent?: string;
+    /** Model exposed from session_created for head session registration */
+    model?: string;
+    /** Target device ID for encrypted create_session routing */
+    targetDeviceId?: string;
+    /** Delivery hint: if true, head should forward but not persist (e.g. deltas, idle) */
+    ephemeral?: boolean;
+}
+export type Message = ProducerMessage | ConsumerMessage | ControlMessage | EncryptedMessage;
+import type { DeviceSummary, DeviceRole, DeviceInfo } from './devices.js';
+import type { SessionSummary } from './sessions.js';
+import type { ToolArgs } from './tools.js';
+export type { DeviceSummary, DeviceRole, DeviceInfo, SessionSummary, ToolArgs };
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAMA,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,sDAAsD;QACtD,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,QAAQ,GAAG;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,QAAQ,GAAG;QAClB,iEAAiE;QACjE,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,QAAQ,GAAG;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,wCAAwC;QACxC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE;QACP,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,MAAM,eAAe,GACvB,qBAAqB,GACrB,mBAAmB,GACnB,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAChB,mBAAmB,GACnB,WAAW,GACX,YAAY,GACZ,qBAAqB,CAAC;AAE1B,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GACzB,iBAAiB,GACjB,eAAe,GACf,cAAc,GACd,eAAe,GACf,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,eAAe,GACf,OAAO,GACP,YAAY,GACZ,SAAS,GACT,MAAM,GACN,cAAc,GACd,QAAQ,GACR,cAAc,GACd,kBAAkB,CAAC;AAEvB,gEAAgE;AAChE,MAAM,MAAM,oBAAoB,GAC5B,qBAAqB,GACrB,MAAM,GACN,gBAAgB,CAAC;AAMrB,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,iEAAiE;QACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE;QACP,+DAA+D;QAC/D,SAAS,EAAE,MAAM,CAAC;QAClB,gCAAgC;QAChC,cAAc,EAAE,MAAM,CAAC;QACvB,kDAAkD;QAClD,KAAK,EAAE,MAAM,CAAC;QACd,sDAAsD;QACtD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,wCAAwC;QACxC,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE;QACP,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,cAAc,GACd,WAAW,GACX,kBAAkB,GAClB,aAAa,GACb,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,qBAAqB,CAAC;AAM1B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,mEAAmE;IACnE,IAAI,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxE;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,sBAAsB,CAAC;CAC9B;AAED,qEAAqE;AACrE,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,+DAA+D;IAC/D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,wCAAwC;IACxC,GAAG,EAAE,OAAO,CAAC;IACb,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gFAAgF;AAChF,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,eAAe,CAAC;IAAG,IAAI,EAAE;QAAE,MAAM,EAAE,aAAa,CAAA;KAAE,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAC;IAAE,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC7E;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,cAAc,CAAC;IAAI,IAAI,EAAE;QAAE,MAAM,EAAE,aAAa,CAAA;KAAE,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAC;IAAE,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC7E;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE;QAAE,OAAO,EAAE,cAAc,CAAA;KAAE,CAAA;CAAE,GACpF;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC;AAE1F,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,aAAa,GACb,gBAAgB,GAChB,oBAAoB,GACpB,mBAAmB,GACnB,kBAAkB,GAClB,aAAa,GACb,eAAe,GACf,yBAAyB,GACzB,0BAA0B,GAC1B,0BAA0B,GAC1B,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,UAAU,CAAC;AAcf,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sFAAsF;IACtF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAMD,MAAM,MAAM,OAAO,GAAG,eAAe,GAAG,eAAe,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAG5F,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC"}

package/dist/messages.js

@@ -0,0 +1,5 @@
+// ------------------------------------------------------------
+// Message types and envelope
+// ------------------------------------------------------------
+export {};
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,6BAA6B;AAC7B,+DAA+D"}

package/dist/sessions.d.ts

@@ -0,0 +1,19 @@
+export interface Session {
+    id: string;
+    channelId: string;
+    deviceId: string;
+    agent: string;
+    model?: string;
+    messageCount: number;
+    lastSeq: number;
+    createdAt: string;
+}
+export interface SessionSummary {
+    id: string;
+    deviceId: string;
+    deviceName: string;
+    agent: string;
+    model?: string;
+    messageCount: number;
+}
+//# sourceMappingURL=sessions.d.ts.map

package/dist/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/sessions.js

@@ -0,0 +1,5 @@
+// ------------------------------------------------------------
+// Session types
+// ------------------------------------------------------------
+export {};
+//# sourceMappingURL=sessions.js.map

package/dist/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gBAAgB;AAChB,+DAA+D"}

package/dist/tools.d.ts

@@ -0,0 +1,44 @@
+export interface ShellToolArgs {
+    command: string;
+}
+export interface WriteFileToolArgs {
+    path: string;
+    content: string;
+}
+export interface ReadFileToolArgs {
+    path: string;
+}
+export interface FetchUrlToolArgs {
+    url: string;
+    method?: string;
+}
+export interface McpToolArgs {
+    server: string;
+    tool: string;
+    params: Record<string, unknown>;
+}
+/** Known tool types with typed arguments */
+export type KnownToolArgs = {
+    toolName: 'shell';
+    args: ShellToolArgs;
+} | {
+    toolName: 'write_file';
+    args: WriteFileToolArgs;
+} | {
+    toolName: 'read_file';
+    args: ReadFileToolArgs;
+} | {
+    toolName: 'fetch_url';
+    args: FetchUrlToolArgs;
+} | {
+    toolName: 'mcp';
+    args: McpToolArgs;
+};
+/** Fallback for agent-specific or future tools */
+export interface UnknownToolArgs {
+    toolName: string;
+    args: Record<string, unknown>;
+}
+/** All possible tool shapes — known tools are typed, unknown allowed */
+export type ToolArgs = KnownToolArgs | UnknownToolArgs;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,4CAA4C;AAC5C,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAM,IAAI,EAAE,aAAa,CAAA;CAAE,GAC/C;IAAE,QAAQ,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GACnD;IAAE,QAAQ,EAAE,WAAW,CAAC;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAClD;IAAE,QAAQ,EAAE,WAAW,CAAC;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAClD;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAQ,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAElD,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,wEAAwE;AACxE,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,eAAe,CAAC"}

package/dist/tools.js

@@ -0,0 +1,5 @@
+// ------------------------------------------------------------
+// Tool types — known tool argument shapes
+// ------------------------------------------------------------
+export {};
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,0CAA0C;AAC1C,+DAA+D"}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@kraki/protocol",
+  "version": "0.1.0",
+  "description": "Shared TypeScript types and message definitions for the Kraki protocol",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  }
+}