jukto-cli 0.1.0

package/README.md

@@ -0,0 +1,109 @@
+# Jukto CLI
+
+Node.js CLI that connects a local machine to the Jukto mobile app through the Jukto gateway. It runs from the project directory you want to expose and keeps filesystem, terminal, process, port, git, and AI actions scoped to that working tree.
+
+## Requirements
+
+- Node.js 18 or newer
+- npm
+- Jukto mobile app for QR/session pairing
+
+## Usage
+
+Run the published package:
+
+```bash
+npx jukto-cli
+```
+
+The CLI prints a QR code and session details. Scan the QR code with the Jukto app to connect to the current working directory.
+
+Common options:
+
+```bash
+npx jukto-cli --help
+npx jukto-cli --new
+npx jukto-cli --debug
+npx jukto-cli --extra-ports 3000,8080
+```
+
+Options:
+
+| Option | Description |
+| --- | --- |
+| `-h`, `--help` | Show CLI help |
+| `-n`, `--new` | Create a fresh session code instead of reusing the saved one |
+| `-d`, `--debug` | Enable verbose CLI and AI backend logs |
+| `--extra-ports` | Comma-separated local ports to expose through Jukto |
+
+## Configuration
+
+By default, the CLI uses the public Jukto services:
+
+- Gateway: `https://gateway.jukto.dev`
+- Manager: `https://manager.jukto.dev`
+
+Override them with environment variables when developing against local or custom infrastructure:
+
+```bash
+JUKTO_PROXY_URL=http://localhost:3001 \
+JUKTO_MANAGER_URL=http://localhost:3002 \
+npx jukto-cli
+```
+
+Other useful environment variables:
+
+| Variable | Description |
+| --- | --- |
+| `JUKTO_PROXY_URL` | Gateway/proxy URL |
+| `JUKTO_MANAGER_URL` | Manager URL |
+| `JUKTO_DEBUG` | Set to `1` for debug logging |
+| `JUKTO_DEBUG_AI` | Set to `1` for AI backend debug logging |
+| `NO_COLOR` | Disable colored terminal output |
+| `FORCE_COLOR` | Force colored terminal output |
+
+Session config is saved per project root in the OS-specific Jukto config directory:
+
+- macOS: `~/Library/Application Support/jukto/config.json`
+- Windows: `%APPDATA.\jukto\config.json`
+- Linux: `$XDG_CONFIG_HOME/jukto/config.json` or `~/.config/jukto/config.json`
+
+## Development
+
+Install dependencies:
+
+```bash
+npm install
+```
+
+Build the CLI:
+
+```bash
+npm run build
+```
+
+Run from source output:
+
+```bash
+npm run dev
+```
+
+The package entrypoint is `dist/index.js`, generated from `src/index.ts`. `npm run build` compiles TypeScript and marks the generated entrypoint executable.
+
+## Project Layout
+
+```text
+src/
+  index.ts              CLI entrypoint and local machine bridge
+  ai/                   Codex/OpenCode provider integration
+  transport/            Session transport protocol
+  libsodium-wrappers.d.ts
+```
+
+## Publishing
+
+The package is published as `jukto-cli`. `prepublishOnly` runs the production build before publishing.
+
+```bash
+npm publish
+```

package/dist/ai/codex.d.ts

@@ -0,0 +1,149 @@
+import type { AIProvider, AiEventEmitter, CodexPromptOptions, FileAttachment, ModelSelector, MessageInfo, ProviderInfo, SessionInfo, ShareInfo } from "./interface.js";
+export declare class CodexProvider implements AIProvider {
+    private proc;
+    private shuttingDown;
+    private emitter;
+    private defaultModelContextWindow;
+    private nextId;
+    private pending;
+    private sessions;
+    private deletedThreadIds;
+    private resumedThreadIds;
+    private pendingPermissionRequestIds;
+    private pendingQuestionRequestIds;
+    private assistantMessageIdByTurnId;
+    private partTextById;
+    private debugLog;
+    private debugHistory;
+    init(): Promise<void>;
+    destroy(): Promise<void>;
+    subscribe(emitter: AiEventEmitter): () => void;
+    createSession(title?: string): Promise<{
+        session: SessionInfo;
+    }>;
+    listSessions(): Promise<{
+        sessions: unknown;
+    }>;
+    getSession(id: string): Promise<{
+        session: SessionInfo;
+    }>;
+    deleteSession(id: string): Promise<{
+        deleted: boolean;
+    }>;
+    renameSession(id: string, title: string): Promise<{
+        session: SessionInfo;
+    }>;
+    getMessages(sessionId: string): Promise<{
+        messages: MessageInfo[];
+    }>;
+    prompt(sessionId: string, text: string, model?: ModelSelector, agent?: string, files?: FileAttachment[], codexOptions?: CodexPromptOptions): Promise<{
+        ack: true;
+    }>;
+    abort(sessionId: string): Promise<Record<string, never>>;
+    agents(): Promise<{
+        agents: unknown;
+    }>;
+    providers(): Promise<ProviderInfo>;
+    setAuth(providerId: string, key: string): Promise<Record<string, never>>;
+    command(sessionId: string, command: string, args: string): Promise<{
+        result: unknown;
+    }>;
+    revert(sessionId: string, messageId: string): Promise<Record<string, never>>;
+    unrevert(sessionId: string): Promise<Record<string, never>>;
+    share(sessionId: string): Promise<{
+        share: ShareInfo;
+    }>;
+    permissionReply(sessionId: string, permissionId: string, response: "once" | "always" | "reject"): Promise<Record<string, never>>;
+    questionReply(sessionId: string, questionId: string, answers: string[][]): Promise<Record<string, never>>;
+    questionReject(sessionId: string, questionId: string): Promise<Record<string, never>>;
+    private send;
+    private call;
+    private handleLine;
+    private handleServerRequest;
+    private handleNotification;
+    private isCommandApprovalMethod;
+    private emitMirroredUserMessage;
+    private handleItemStarted;
+    private handleStructuredItemCompleted;
+    private emitTextPart;
+    private emitStructuredToolPart;
+    private finishAssistantTurn;
+    private emitMessagePartEvent;
+    private ensureAssistantMessage;
+    private upsertLocalMessagePart;
+    private fetchServerThreads;
+    private refreshConfigDefaults;
+    private refreshSessionMetadata;
+    private fetchServerThreadsByArchiveState;
+    private fetchModels;
+    private fetchModelById;
+    private resolveModelId;
+    private buildCollaborationMode;
+    private parseThreadListEntry;
+    private hasNextCursor;
+    private ingestThreadMetadata;
+    private reconcileSessionsWithServer;
+    private mergeSession;
+    private upsertSession;
+    private ensureLocalSession;
+    private ensureThreadResumed;
+    private resolveSessionFromPayload;
+    private resolveInFlightTurnId;
+    private decodeMessagesFromThreadRead;
+    private logThreadReadSummary;
+    private decodeStoredToolLikePart;
+    private describeStoredToolName;
+    private extractStoredToolInput;
+    private extractStoredToolOutput;
+    private decodeStoredCommandExecutionOutput;
+    private decodeUserMessageParts;
+    private decodeItemText;
+    private makeTurnInputPayload;
+    private shouldRetryTurnStartWithImageURLField;
+    private inferImageMimeFromDataUrl;
+    private decodeReasoningItemText;
+    private decodePlanItemText;
+    private decodeCommandExecutionItemText;
+    private decodeFileLikeItemText;
+    private normalizedCommandPhase;
+    private shortCommand;
+    private flattenTextValue;
+    private toSessionInfo;
+    private extractThreadObject;
+    private extractThreadTitleFromUnknown;
+    private extractThreadTitle;
+    private extractTurnId;
+    private extractItemId;
+    private extractTextPayload;
+    private extractStructuredUserInputQuestions;
+    private extractThreadId;
+    private extractThreadCwd;
+    private extractCreatedAt;
+    private extractUpdatedAt;
+    private readTimestamp;
+    private firstString;
+    private firstStringFromSources;
+    private readArray;
+    private readRawString;
+    private readString;
+    private asRecord;
+    private normalizedItemType;
+    private isUserRole;
+    private isAssistantMessageItem;
+    private extractIncomingItem;
+    private describeToolPart;
+    private normalizeStructuredType;
+    private isFileChangeStructuredItem;
+    private extractStructuredOutput;
+    private extractDiffLikePayload;
+    private renderFileChangeEntriesBody;
+    private renderUnifiedDiffBody;
+    private extractCanonicalPatch;
+    private normalizeDisplayPath;
+    private normalizeDirectoryPath;
+    private belongsToCurrentRoot;
+    private normalizedFileChangeStatus;
+    private extractToolInput;
+    private extractCommandExecutionInput;
+    private describeCompletedItemOutput;
+}