@farmslot/protocol 0.38.0 → 0.40.0

package/dist/contracts/runner-mobile-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-mobile-keys.d.ts","sourceRoot":"","sources":["../../src/contracts/runner-mobile-keys.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,+FAA+F;IAC/F,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,SAAS,EAAE,qBAAqB,CAAC;IACjC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;CAClC;AAYD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkKoB,CAAC;AAM5D,wBAAgB,sBAAsB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,sBAAsB,GAAG,IAAI,CAG9F"}

package/dist/contracts/runner-mobile-keys.js

@@ -0,0 +1,189 @@
+// runner-mobile-keys.ts — extra phone terminal keys per runner. The gateway
+// runner registry references each profile from its RunnerDefinition; Companion
+// looks a profile up by runner id. Each key records the CLI build and the
+// documented binding it was read from. Exec-only runners have no profile; an
+// interactive runner with no documented extra keys has an empty one.
+//
+// Inventoried on macpro, 2026-10-10. References are relative to each CLI's
+// installed package. Chords that tmux cannot pass distinctly (Ctrl+I, Ctrl+M,
+// Shift+Enter), a default tmux prefix (Ctrl+B), double Esc sent as one write,
+// and destructive chords are left out.
+import { normalizeRunner } from './runner-ids.js';
+const CLAUDE = 'claude 2.1.296';
+const CLAUDE_KEYMAP = 'default keymap in the @anthropic-ai/claude-code-darwin-arm64 claude binary';
+const CODEX = 'codex-cli 0.162.1';
+const CURSOR = 'cursor-agent 2026.09.28-64d2043';
+const CURSOR_BUNDLE = 'versions/2026.09.28-64d2043/6949.index.js';
+const GROK = 'grok 1.0.50';
+const GROK_DOC = '~/.grok/docs/user-guide/03-keyboard-shortcuts.md';
+const PI = 'pi 0.87.0';
+const PI_DOC = '@earendil-works/pi-coding-agent/docs/keybindings.md';
+export const RUNNER_MOBILE_KEY_PROFILES = {
+    claude: {
+        runnerId: 'claude',
+        label: 'Claude Code',
+        inventory: { cliVersion: CLAUDE, reference: `README.md (no key list); ${CLAUDE_KEYMAP}` },
+        keys: [
+            {
+                label: 'Transcript',
+                data: '\x0f',
+                danger: false,
+                chord: 'Ctrl+O',
+                source: {
+                    cliVersion: CLAUDE,
+                    reference: `${CLAUDE_KEYMAP}: "ctrl+o":"app:toggleTranscript"`,
+                },
+            },
+            {
+                label: 'History',
+                data: '\x12',
+                danger: false,
+                chord: 'Ctrl+R',
+                source: { cliVersion: CLAUDE, reference: `${CLAUDE_KEYMAP}: "ctrl+r":"history:search"` },
+            },
+            {
+                label: 'Model',
+                data: '\x1bp',
+                danger: false,
+                chord: 'Meta+P',
+                source: { cliVersion: CLAUDE, reference: `${CLAUDE_KEYMAP}: "meta+p":"chat:modelPicker"` },
+            },
+        ],
+    },
+    codex: {
+        runnerId: 'codex',
+        label: 'Codex',
+        // The seeded skip keys (Left, Shift+Left, Ctrl+[) are not mapped by any of these sources.
+        inventory: {
+            cliVersion: CODEX,
+            reference: 'README.md, `codex --help`, `codex debug --help` and the app-server JSON schema; none lists key bindings',
+        },
+        keys: [],
+    },
+    cursor: {
+        runnerId: 'cursor',
+        label: 'Cursor Agent',
+        inventory: {
+            cliVersion: CURSOR,
+            reference: `\`cursor-agent --help\` (no key list); ${CURSOR_BUNDLE}`,
+        },
+        keys: [
+            {
+                label: 'Expand',
+                data: '\x0f',
+                danger: false,
+                chord: 'Ctrl+O',
+                source: { cliVersion: CURSOR, reference: `${CURSOR_BUNDLE}: "ctrl+o to expand"` },
+            },
+            {
+                label: 'Review',
+                data: '\x12',
+                danger: false,
+                chord: 'Ctrl+R',
+                source: {
+                    cliVersion: CURSOR,
+                    reference: `${CURSOR_BUNDLE}: "ctrl+r to review changed files"`,
+                },
+            },
+            {
+                label: 'Newline',
+                data: '\n',
+                danger: false,
+                chord: 'Ctrl+J',
+                source: { cliVersion: CURSOR, reference: `${CURSOR_BUNDLE}: "Ctrl+J for newlines"` },
+            },
+            {
+                // Same byte as the generic Esc key; kept for the question-skip action it names.
+                label: 'Skip',
+                data: '\x1b',
+                danger: false,
+                chord: 'Esc',
+                source: { cliVersion: CURSOR, reference: `${CURSOR_BUNDLE}: "Esc to skip"` },
+            },
+        ],
+    },
+    grok: {
+        runnerId: 'grok',
+        label: 'Grok',
+        inventory: { cliVersion: GROK, reference: GROK_DOC },
+        keys: [
+            {
+                label: 'Palette',
+                data: '\x10',
+                danger: false,
+                chord: 'Ctrl+P',
+                source: { cliVersion: GROK, reference: `${GROK_DOC}:247` },
+            },
+            {
+                label: 'Sessions',
+                data: '\x12',
+                danger: false,
+                chord: 'Ctrl+R',
+                source: { cliVersion: GROK, reference: `${GROK_DOC}:253` },
+            },
+            {
+                label: 'Tasks',
+                data: '\x07',
+                danger: false,
+                chord: 'Ctrl+G',
+                source: { cliVersion: GROK, reference: `${GROK_DOC}:258` },
+            },
+            {
+                label: 'Prev turn',
+                data: '\x1b[1;2D',
+                danger: false,
+                chord: 'Shift+Left',
+                source: { cliVersion: GROK, reference: `${GROK_DOC}:36 (scrollback focused)` },
+            },
+            {
+                label: 'Next turn',
+                data: '\x1b[1;2C',
+                danger: false,
+                chord: 'Shift+Right',
+                source: { cliVersion: GROK, reference: `${GROK_DOC}:35 (scrollback focused)` },
+            },
+        ],
+    },
+    pi: {
+        runnerId: 'pi',
+        label: 'Pi',
+        inventory: { cliVersion: PI, reference: PI_DOC },
+        keys: [
+            {
+                label: 'Tools',
+                data: '\x0f',
+                danger: false,
+                chord: 'Ctrl+O',
+                source: { cliVersion: PI, reference: `${PI_DOC}:163 app.tools.expand` },
+            },
+            {
+                label: 'Thinking',
+                data: '\x14',
+                danger: false,
+                chord: 'Ctrl+T',
+                source: { cliVersion: PI, reference: `${PI_DOC}:157 app.thinking.toggle` },
+            },
+            {
+                label: 'Follow-up',
+                data: '\x1b\r',
+                danger: false,
+                chord: 'Alt+Enter',
+                source: { cliVersion: PI, reference: `${PI_DOC}:165 app.message.followUp` },
+            },
+            {
+                label: 'Dequeue',
+                data: '\x1b[1;3A',
+                danger: false,
+                chord: 'Alt+Up',
+                source: { cliVersion: PI, reference: `${PI_DOC}:166 app.message.dequeue` },
+            },
+        ],
+    },
+};
+const PROFILES_BY_RUNNER = new Map(Object.values(RUNNER_MOBILE_KEY_PROFILES).map((profile) => [profile.runnerId, profile]));
+export function runnerMobileKeyProfile(runnerId) {
+    if (!runnerId?.trim())
+        return null;
+    return PROFILES_BY_RUNNER.get(normalizeRunner(runnerId)) ?? null;
+}
+//# sourceMappingURL=runner-mobile-keys.js.map

package/dist/contracts/runner-mobile-keys.js.map

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