@shuyhere/takotako 0.0.1

package/dist/gateway/protocol.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Wire protocol types for the Tako Gateway WebSocket API.
+ */
+export type ClientMessage = {
+    type: 'auth';
+    token: string;
+} | {
+    type: 'chat';
+    sessionId: string;
+    content: string;
+    attachments?: string[];
+} | {
+    type: 'command';
+    cmd: string;
+    args: string;
+} | {
+    type: 'session_create';
+    name?: string;
+} | {
+    type: 'session_resume';
+    sessionId: string;
+} | {
+    type: 'session_list';
+} | {
+    type: 'status';
+} | {
+    type: 'ping';
+};
+export type ServerMessage = {
+    type: 'auth_ok';
+    sessionId?: string;
+} | {
+    type: 'auth_error';
+    reason: string;
+} | {
+    type: 'chunk';
+    sessionId: string;
+    text: string;
+} | {
+    type: 'text_delta';
+    content: string;
+} | {
+    type: 'text_done';
+    content: string;
+} | {
+    type: 'tool_start';
+    sessionId: string;
+    name: string;
+    params: unknown;
+} | {
+    type: 'tool_end';
+    sessionId: string;
+    name: string;
+    result: string;
+} | {
+    type: 'tool_call';
+    sessionId: string;
+    name: string;
+    params: unknown;
+} | {
+    type: 'tool_result';
+    sessionId: string;
+    name: string;
+    result: string;
+} | {
+    type: 'done';
+    sessionId: string;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+    };
+} | {
+    type: 'error';
+    sessionId?: string;
+    message: string;
+} | {
+    type: 'session_created';
+    sessionId: string;
+    name: string;
+} | {
+    type: 'session_list';
+    sessions: SessionInfo[];
+} | {
+    type: 'status_info';
+    model: string;
+    tools: number;
+    skills: number;
+    uptime: number;
+    channels: string[];
+} | {
+    type: 'pong';
+};
+export interface SessionInfo {
+    id: string;
+    name: string;
+    createdAt: string;
+    lastActiveAt: string;
+    messageCount: number;
+}
+export type GatewayEvent = {
+    type: 'client_connected';
+    clientId: string;
+} | {
+    type: 'client_disconnected';
+    clientId: string;
+} | {
+    type: 'session_created';
+    sessionId: string;
+} | {
+    type: 'session_ended';
+    sessionId: string;
+} | {
+    type: 'error';
+    error: Error;
+};
+export type EventHandler = (event: GatewayEvent) => void | Promise<void>;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/gateway/protocol.d.ts.map

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

package/dist/gateway/protocol.js

@@ -0,0 +1,5 @@
+/**
+ * Wire protocol types for the Tako Gateway WebSocket API.
+ */
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/gateway/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/gateway/protocol.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/gateway/session.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Session management — create, resume, persist, compact sessions.
+ *
+ * Sessions are persisted per-agent as append-only JSONL transcripts:
+ *   ~/.tako/agents/<agentId>/sessions/<sessionId>.jsonl
+ *
+ * A sessions.json index in each dir maps composite keys → session IDs.
+ * Old session files are never deleted — only archived (removed from
+ * active maps but kept on disk).
+ */
+import type { ChatMessage } from '../providers/provider.js';
+export interface Session {
+    id: string;
+    name: string;
+    createdAt: Date;
+    lastActiveAt: Date;
+    messages: ChatMessage[];
+    metadata: Record<string, unknown>;
+}
+export interface SessionCreateOpts {
+    name?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare class SessionManager {
+    private sessions;
+    private dirty;
+    private flushTimer;
+    private indexDirty;
+    /** Keyed sessions: maps composite keys to session IDs. */
+    private keyIndex;
+    /** Per-agent session directories: agentId → absolute dir path */
+    private agentDirs;
+    /** Fallback dir for sessions without a known agent. */
+    private fallbackDir;
+    /** Whether persistence has been enabled. */
+    private persistEnabled;
+    /** Tracks how many messages have been flushed to JSONL per session. */
+    private lastFlushedIndex;
+    /**
+     * Enable persistence with per-agent directories.
+     * @param agentDirs Map of agentId → session directory path
+     * @param fallbackDir Default dir for sessions that don't match any agent
+     */
+    enablePersistence(agentDirs: Map<string, string> | Record<string, string>, fallbackDir?: string): Promise<void>;
+    /** Register an additional agent directory at runtime. */
+    registerAgentDir(agentId: string, dir: string): Promise<void>;
+    /** Stop background flush timer. */
+    stopPersistence(): void;
+    /** Create a new session. */
+    create(opts?: SessionCreateOpts): Session;
+    /**
+     * Get or create a session by composite key.
+     * Key format: agent:<agentId>:<platform>:<type>:<target>
+     */
+    getOrCreate(key: string, opts?: SessionCreateOpts): Session & {
+        isNew?: boolean;
+    };
+    /** Get a session by ID. */
+    get(id: string): Session | undefined;
+    /** Get a session by composite key. */
+    getByKey(key: string): Session | undefined;
+    /** List all sessions. */
+    list(): Session[];
+    /** List sessions filtered by agent ID. */
+    listByAgent(agentId: string): Session[];
+    /** Check if a session has been idle longer than the timeout (24h). */
+    isIdle(session: Session): boolean;
+    /** Return all sessions that have exceeded the idle timeout. */
+    sweepIdle(): Session[];
+    /** Append a message to a session. */
+    addMessage(sessionId: string, message: ChatMessage): void;
+    /**
+     * Archive a session — remove from active maps, rename file for audit trail.
+     * Files are never deleted, only renamed with a .deleted timestamp suffix.
+     */
+    archiveSession(id: string): boolean;
+    /** Delete a session from active maps. File renamed with .deleted suffix. */
+    delete(id: string): boolean;
+    /**
+     * Reset a session — rename the JSONL file with .reset suffix, clear messages.
+     * Used by /new command. Full audit trail is preserved.
+     */
+    resetSession(id: string): Promise<void>;
+    /**
+     * Rename a session's JSONL file with a suffix and ISO timestamp.
+     * E.g. <id>.jsonl → <id>.jsonl.reset.2026-03-06T22-00-00.000Z
+     */
+    private renameSessionFile;
+    /** Compact a session — trim old messages keeping the most recent. */
+    compact(sessionId: string, keepLast?: number): Promise<void>;
+    /**
+     * Rotate all active sessions — archive current ones and create fresh replacements.
+     * Used for daily 4 AM reset. Old files stay on disk.
+     */
+    rotateAllSessions(): Promise<{
+        archived: string[];
+        created: string[];
+    }>;
+    /** Flush all dirty sessions to disk. */
+    flushDirty(): Promise<void>;
+    /** Flush everything and clean up. */
+    shutdown(): Promise<void>;
+    private markDirty;
+    /** Externally mark a session as needing persistence and flush immediately. */
+    markSessionDirty(id: string): void;
+    /** Resolve the persist directory for a session based on its agentId. */
+    private getDirForSession;
+    /** Strip non-serializable runtime refs from metadata. */
+    private stripRuntime;
+    /** Append new messages to a session's JSONL transcript. */
+    private appendToJSONL;
+    /** Atomic full rewrite of a JSONL file (used after compaction). */
+    private rewriteJsonl;
+    /** Persist sessions.json index to each agent dir. */
+    private saveIndexFiles;
+    /** Load sessions + index from a single agent directory. */
+    private loadFromDir;
+    /** Parse a JSONL transcript file and reconstruct a Session. */
+    private loadJsonlFile;
+    /** Load a legacy full-JSON session file. */
+    private loadLegacyJsonFile;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/gateway/session.d.ts.map

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