agentstreamdeck 2.1.1__py3-none-any.whl

ocdeck/runtime/plugins/harnesses/install.mjs

@@ -0,0 +1,83 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import {fileURLToPath} from 'node:url';
+import {profiles} from './profiles.mjs';
+
+export function configuration(profile, script = fileURLToPath(new URL('./hook.mjs', import.meta.url))) {
+  const p = profiles[profile];
+  if (!p) throw Error('Unknown harness: ' + profile);
+  // Double quotes work in Bash, cmd and PowerShell for these paths. Refuse shell metacharacters
+  // that could expand even inside quotes; never interpolate user prompts into commands.
+  script = script.replaceAll('\\', '/');
+  if (/["$`%!\r\n]/.test(script)) throw Error('Move AgentStreamDeck to a path without quotes, $, backticks, %, or !');
+  const hooks = {};
+  for (const event of Object.keys(p.events)) {
+    const command = `node "${script}" ${profile} ${event}`;
+    let entry = {type:'command', command, timeout:5};
+    if (p.format === 'copilot') entry = {type:'command', bash:command, powershell:command, timeoutSec:5};
+    if (p.format === 'cursor') entry = {command, timeout:5};
+    if (p.format === 'nested') {
+      // Gemini measures hook timeout in milliseconds; Claude measures seconds.
+      if (profile === 'gemini') entry.timeout = 5000;
+      if (profile === 'codex' && ['SessionEnd','Interrupt'].includes(event)) entry.timeout = 3;
+      entry = {hooks:[entry]};
+    }
+    hooks[event] = [entry];
+  }
+  return {...(['copilot','cursor'].includes(p.format) ? {version:1} : {}), hooks};
+}
+const same = (a,b) => JSON.stringify(a) === JSON.stringify(b);
+export function mergeConfig(existing, generated, prior = null) {
+  const result = structuredClone(existing);
+  if (!result || typeof result !== 'object' || Array.isArray(result)) throw Error('Config must be an object');
+  result.hooks ??= {};
+  if (typeof result.hooks !== 'object' || Array.isArray(result.hooks) || result.hooks === null) throw Error('hooks must be an object');
+  if (generated.version && result.version !== undefined && result.version !== generated.version) throw Error('Unsupported config version');
+  if (generated.version) result.version = generated.version;
+  for (const [event, entries] of Object.entries(prior?.hooks || {})) {
+    if (result.hooks[event] !== undefined && !Array.isArray(result.hooks[event])) throw Error('Invalid hook array: ' + event);
+    if (result.hooks[event]) result.hooks[event] = result.hooks[event].filter(x => !entries.some(y => same(x,y)));
+  }
+  for (const [event, entries] of Object.entries(generated.hooks)) {
+    result.hooks[event] ??= [];
+    if (!Array.isArray(result.hooks[event])) throw Error('Invalid hook array: ' + event);
+    for (const entry of entries) if (!result.hooks[event].some(x => same(x,entry))) result.hooks[event].push(entry);
+  }
+  for (const event of Object.keys(result.hooks)) if (result.hooks[event].length === 0) delete result.hooks[event];
+  return result;
+}
+async function read(file, fallback) {
+  try { return JSON.parse((await fs.readFile(file,'utf8')).replace(/^\uFEFF/, '')); }
+  catch (e) { if (e.code === 'ENOENT') return fallback; throw Error(`Cannot parse ${file}; merge JSONC manually: ${e.message}`); }
+}
+async function atomic(file, value) {
+  await fs.mkdir(path.dirname(file), {recursive:true});
+  await fs.writeFile(file + '.agentdeck-tmp', JSON.stringify(value,null,2)+'\n', {flag:'wx'});
+  await fs.rename(file + '.agentdeck-tmp', file);
+}
+export async function install(profile, project, {remove=false, dryRun=false} = {}) {
+  if (!profiles[profile]) throw Error('Unknown harness');
+  const target = path.resolve(project, profiles[profile].config);
+  const manifest = path.resolve(project, '.agentdeck', profile + '.json');
+  const prior = await read(manifest, null);
+  if (prior && prior.target !== target) throw Error('Project moved; remove old hooks manually before reinstalling');
+  const existing = await read(target, {});
+  const generated = remove ? {hooks:{}} : configuration(profile);
+  const merged = mergeConfig(existing, generated, prior?.configuration);
+  if (dryRun) return {target, configuration:merged};
+  if (remove && !prior) throw Error('No AgentStreamDeck installation manifest; nothing removed');
+  if (!same(existing,merged)) {
+    try { await fs.copyFile(target, target + `.agentdeck-backup-${Date.now()}`, 1); }
+    catch (e) { if (e.code !== 'ENOENT') throw e; }
+    await atomic(target,merged);
+  }
+  if (remove) await fs.rm(manifest, {force:true});
+  else await atomic(manifest, {target, configuration:generated});
+  return {target, action:remove ? 'removed' : 'installed'};
+}
+if (process.argv[2] === '--cli') {
+  try {
+    const [profile, project, ...flags] = process.argv.slice(3);
+    console.log(JSON.stringify(await install(profile, project, {remove:flags.includes('--remove'), dryRun:flags.includes('--dry-run')}),null,2));
+  } catch (e) { console.error(e.message); process.exitCode = 1; }
+}

ocdeck/runtime/plugins/harnesses/profiles.mjs

@@ -0,0 +1,107 @@
+import crypto from 'node:crypto';
+// Native hook names stay here; transport and the broker remain harness-neutral.
+export const profiles = {
+  codex: {
+    label:'Codex', executable:'codex', config:'.codex/hooks.json', format:'nested',
+    events:{SessionStart:'start', SessionEnd:'end', UserPromptSubmit:'busy', PreToolUse:'tool',
+      PostToolUse:'result', PermissionRequest:'codex-permission', Stop:'idle', Interrupt:'idle', PreCompact:'busy'},
+    questions:['request_user_input'],
+  },
+  claude: {
+    label: 'Claude', executable: 'claude', config: '.claude/settings.local.json', format: 'nested',
+    events: {SessionStart:'start', SessionEnd:'end', UserPromptSubmit:'busy', PreToolUse:'tool',
+      PostToolUse:'result', PostToolUseFailure:'result', PermissionRequest:'permission',
+      Notification:'notification', Stop:'idle', StopFailure:'error', PreCompact:'busy'},
+    questions: ['AskUserQuestion'],
+  },
+  'copilot-cli': {
+    label: 'Copilot CLI', executable: 'copilot', config: '.github/hooks/agentdeck-copilot-cli.json', format: 'copilot',
+    events: {sessionStart:'start', sessionEnd:'end', userPromptSubmitted:'busy', preToolUse:'tool',
+      postToolUse:'result', postToolUseFailure:'result', agentStop:'idle', errorOccurred:'error'},
+    questions: [], // CLI payloads do not guarantee paired tool-call IDs.
+  },
+  'copilot-vscode': {
+    label: 'Copilot VS Code', executable: 'code', config: '.github/hooks/agentdeck-copilot-vscode.json', format: 'vscode',
+    events: {SessionStart:'start', UserPromptSubmit:'busy', PreToolUse:'tool', PostToolUse:'result',
+      Stop:'idle', PreCompact:'busy'}, questions: [],
+  },
+  gemini: {
+    label: 'Gemini', executable: 'gemini', config: '.gemini/settings.json', format: 'nested',
+    events: {SessionStart:'start', SessionEnd:'end', BeforeAgent:'busy', BeforeModel:'busy',
+      BeforeTool:'tool', AfterTool:'result', AfterAgent:'idle', Notification:'notification', PreCompress:'busy'},
+    questions: [],
+  },
+  cursor: {
+    label: 'Cursor CLI', executable: 'agent', config: '.cursor/hooks.json', format: 'cursor',
+    events: {sessionStart:'start', sessionEnd:'end', beforeSubmitPrompt:'busy', preToolUse:'tool',
+      postToolUse:'result', postToolUseFailure:'result', stop:'idle', preCompact:'busy'}, questions: [],
+  },
+};
+
+// Allowlist only metadata. Never forward prompts, commands, outputs or transcripts.
+export function normalize(profile, event, input) {
+  const p = profiles[profile];
+  if (!p || !Object.hasOwn(p.events, event) || !input || typeof input !== 'object' || Array.isArray(input)) return null;
+  const str = x => typeof x === 'string' && x.length <= 512 ? x : '';
+  const session = str(input.session_id || input.sessionId || input.conversation_id);
+  if (!session) return null; // Never guess identity from cwd or hook PID.
+  return {event, session, tool: str(input.tool_name || input.toolName),
+    request: str(input.tool_use_id || input.toolUseId),
+    notification: str(input.notification_type), failed: input.status === 'error' || input.status === 'aborted'};
+}
+
+export class HookFacts {
+  constructor(profile) {
+    if (!profiles[profile]) throw Error('Unknown harness');
+    this.profile = profiles[profile]; this.sessions = new Map(); this.seen = false; this.broken = false;
+  }
+  event(e) {
+    const action = this.profile.events[e.event];
+    if (!action || typeof e.session !== 'string' || !e.session) return;
+    this.seen = true;
+    if (action === 'end') { this.sessions.delete(e.session); return; }
+    const s = this.sessions.get(e.session) || {status:'unknown', pending:new Set(), detail:'', inputNeeded:false};
+    this.sessions.set(e.session, s);
+    if (action === 'codex-permission') {
+      s.inputNeeded = true; s.status = 'busy'; s.detail = 'Approval requested; count unknown'; return;
+    }
+    if (['start','idle','busy','result','error'].includes(action)) s.inputNeeded = false;
+    if (action === 'notification') {
+      // No request ID or resolution event: do not invent a pending count.
+      if (e.notification === 'permission_prompt' || e.notification === 'ToolPermission') {
+        s.status = 'unknown'; s.detail = 'Permission notification; inspect harness';
+      }
+      return;
+    }
+    if (action === 'permission') {
+      s.status = 'unknown'; s.detail = 'Permission decision; no paired request ID'; return;
+    }
+    s.detail = '';
+    if (action === 'error' || e.failed) {
+      s.status = 'unknown'; s.pending.clear(); s.detail = 'Harness error; inspect terminal';
+    } else if (action === 'start' || action === 'idle') {
+      s.status = 'idle'; s.pending.clear();
+    } else {
+      s.status = 'busy';
+      if (action === 'busy') s.pending.clear(); // New turn cancels unresolved prior-turn questions.
+      if (action === 'tool' && e.request && this.profile.questions.includes(e.tool)) s.pending.add(e.request);
+      if (action === 'result' && e.request) s.pending.delete(e.request);
+    }
+  }
+  snapshot() {
+    let status = this.seen && !this.broken ? 'idle' : 'unknown', pending = 0, detail = '';
+    for (const s of this.sessions.values()) {
+      pending += s.pending.size;
+      if (s.status === 'unknown') status = 'unknown';
+      else if (status !== 'unknown' && s.status === 'busy') status = 'busy';
+      if (s.detail) detail = s.detail;
+    }
+    if (!this.seen) detail = 'Waiting for first harness hook';
+    if (this.broken) detail = 'Hook delivery failed; restart managed session';
+    const requestIds = [];
+    for (const [session, s] of this.sessions) for (const id of s.pending)
+      requestIds.push(crypto.createHash('sha256').update(JSON.stringify([session,id])).digest('hex'));
+    return {status, pending, detail, pendingKnown:false,
+      inputNeeded:[...this.sessions.values()].some(s => s.inputNeeded), requestIds};
+  }
+}

ocdeck/runtime/plugins/server.mjs

@@ -0,0 +1,67 @@
+import {Bridge, Facts, registration} from './core.mjs';
+
+// Conventional globally loaded server plugin. No npm package dependencies.
+export async function DeckBridge({client, directory}) {
+  if (process.argv.some(a => ['serve', 'run', 'web', 'acp'].includes(a)) && !process.env.OCDECK_BINDING) return {};
+  const globalKey = Symbol.for('ryan.ocdeck.server.instance');
+  // OpenCode may initialize its server plugin more than once per process.
+  // Reuse one adapter; do not allocate a key per project initialization.
+  if (globalThis[globalKey]) return globalThis[globalKey];
+  let reg;
+  // Bindings can appear a few milliseconds after process creation.
+  try { reg = await registration(); } catch { return {}; }
+  if (!reg) return {};
+  const facts = new Facts();
+  let eventRevision = 0;
+  let lastReconcile = 0;
+  let lastError = 0;
+  async function reconcile() {
+    if (Date.now() - lastReconcile < 4000) return;
+    lastReconcile = Date.now();
+    const revision = eventRevision;
+    // These list methods differ between SDK generations. Missing methods are
+    // a diagnosed limitation; live events still provide pending request state.
+    const jobs = [];
+    if (client.session?.status) jobs.push(['status', client.session.status({query: {directory}})]);
+    if (client.permission?.list) jobs.push(['permissions', client.permission.list({query: {directory}})]);
+    if (client.question?.list) jobs.push(['questions', client.question.list({query: {directory}})]);
+    const results = await Promise.all(jobs.map(async ([key, p]) => [key, await Promise.race([
+      p, new Promise((_, reject) => setTimeout(() => reject(Error('Snapshot timed out')), 1000))]) ]));
+    if (eventRevision !== revision) return; // Never overwrite an intervening event.
+    for (const [key, response] of results) {
+      if (response.error) throw Error(`OpenCode ${key} snapshot failed`);
+      const data = response.data;
+      if (key === 'status' && data && !Array.isArray(data)) {
+        for (const [id, s] of facts.sessions) s.status = data[id]?.type || 'idle';
+        for (const [id, status] of Object.entries(data)) facts.session(id).status = status.type;
+      } else if (Array.isArray(data)) {
+        for (const s of facts.sessions.values()) s[key].clear();
+        for (const r of data) facts.session(r.sessionID)[key].add(r.id);
+      }
+    }
+    facts.trusted = true;
+    if (facts.detail === 'OpenCode snapshot unavailable') facts.detail = '';
+  }
+  const bridge = new Bridge({registration: reg,
+    readSnapshot: async () => {
+      try { await reconcile(); }
+      catch { facts.trusted = false; facts.detail = 'OpenCode snapshot unavailable'; }
+      return facts.snapshot();
+    },
+    onError: error => {
+      if (Date.now() - lastError < 30000) return;
+      lastError = Date.now();
+      try { Promise.resolve(client.app?.log?.({body: {service: 'ocdeck', level: 'warn', message: error}})).catch(() => {}); } catch {}
+    }});
+  bridge.start();
+  const hooks = {
+    event: async ({event}) => {
+      if (/^(session\.|permission\.|question\.)/.test(event.type)) {
+        eventRevision++; facts.event(event); void bridge.flush();
+      }
+    },
+    dispose: async () => { await bridge.close(); delete globalThis[globalKey]; }
+  };
+  globalThis[globalKey] = hooks;
+  return hooks;
+}

ocdeck/runtime/plugins/tui.mjs

@@ -0,0 +1,44 @@
+import {Bridge, registration} from './core.mjs';
+
+// Opt-in replacement for server adapter, after verifying installed TUI support.
+export default {
+  id: 'ryan.opencode.deck',
+  async tui(api) {
+    const reg = await registration();
+    if (!reg) return;
+    const known = new Set();
+    const snapshot = () => {
+      if (!api.state.ready) return {status: 'unknown', pending: 0};
+      const route = api.route.current;
+      if (route.name === 'session' && route.params?.sessionID) known.add(route.params.sessionID);
+      let status = 'idle', pending = 0;
+      for (const id of known) {
+        const s = api.state.session.status(id);
+        if (s?.type === 'busy' || s?.type === 'retry') status = 'busy';
+        pending += api.state.session.permission(id).length + api.state.session.question(id).length;
+      }
+      return {status, pending};
+    };
+    const bridge = new Bridge({registration: reg, readSnapshot: snapshot});
+    const events = ['session.status', 'permission.asked', 'permission.replied',
+                    'question.asked', 'question.replied', 'question.rejected'];
+    const unsubscribe = events.map(type => api.event.on(type, event => {
+      const id = event.properties?.sessionID;
+      // Include descendant activity only when its root belongs to this TUI.
+      let s = id && api.state.session.get(id), visited = new Set();
+      while (s?.parentID && !visited.has(s.id)) {
+        visited.add(s.id);
+        if (known.has(s.parentID)) { known.add(id); break; }
+        s = api.state.session.get(s.parentID);
+      }
+      setTimeout(() => void bridge.flush(), 0);
+    }));
+    bridge.start();
+    // Local state observation also catches TUI route changes without a server event.
+    const timer = setInterval(() => void bridge.flush(), 500);
+    timer.unref?.();
+    api.lifecycle.onDispose(async () => {
+      clearInterval(timer); unsubscribe.forEach(f => f()); await bridge.close();
+    });
+  }
+};

ocdeck/runtime/scripts/Install-Harness.ps1

@@ -0,0 +1,20 @@
+param(
+    [Parameter(Mandatory=$true)]
+    [ValidateSet('claude','copilot-cli','copilot-vscode','gemini','cursor','codex')][string]$Profile,
+    [string]$Project = (Get-Location).Path,
+    [switch]$Remove,
+    [switch]$DryRun
+)
+$ErrorActionPreference = 'Stop'
+$source = Split-Path -Parent $PSScriptRoot
+$runtime = Join-Path $env:USERPROFILE '.opencode-deck\venv\Scripts\python.exe'
+if (-not (Test-Path -LiteralPath $runtime)) { $runtime = 'python' }
+$oldPythonPath = $env:PYTHONPATH
+try {
+    $env:PYTHONPATH = $source + [IO.Path]::PathSeparator + $oldPythonPath
+    $arguments = @('-m','ocdeck','harness-install',$Profile,'--project',$Project)
+    if ($Remove) { $arguments += '--remove' }
+    if ($DryRun) { $arguments += '--dry-run' }
+    & $runtime @arguments
+    if ($LASTEXITCODE -ne 0) { throw 'Harness configuration failed; inspect the message above.' }
+} finally { $env:PYTHONPATH = $oldPythonPath }

ocdeck/runtime/scripts/Install.ps1

@@ -0,0 +1,79 @@
+param(
+    [string]$Python = 'python',
+    [string]$OpenCodePath,
+    [string]$ConfigDirectory,
+    [ValidateSet('server','tui')][string]$PluginMode = 'server'
+)
+$ErrorActionPreference = 'Stop'
+$source = Split-Path -Parent $PSScriptRoot
+$data = Join-Path $env:USERPROFILE '.opencode-deck'
+$old = $null
+if (Test-Path (Join-Path $data 'install.json')) {
+    $old = Get-Content (Join-Path $data 'install.json') -Raw | ConvertFrom-Json
+}
+if (-not $OpenCodePath) {
+    if ($old -and (Test-Path -LiteralPath $old.opencode)) { $OpenCodePath = $old.opencode }
+    else {
+        $command = Get-Command opencode -ErrorAction SilentlyContinue
+        if ($command) { $OpenCodePath = $command.Source }
+    }
+}
+if (-not $OpenCodePath -or -not (Test-Path -LiteralPath $OpenCodePath)) {
+    throw 'Install OpenCode first, or pass -OpenCodePath with its actual executable/shim path.'
+}
+if ($OpenCodePath.StartsWith((Join-Path $data 'bin'), [StringComparison]::OrdinalIgnoreCase)) {
+    throw 'OpenCodePath points to this launcher. Supply the original OpenCode executable.'
+}
+& $Python -c 'import sys; assert sys.version_info >= (3,11), "Python 3.11 or newer required"'
+if ($LASTEXITCODE -ne 0) { throw 'Python 3.11+ is required; use -Python with its executable path.' }
+New-Item -ItemType Directory -Force -Path $data | Out-Null
+# Per-user token/discovery protection. Do not broaden ACLs or require an administrator.
+$user = [System.Security.Principal.WindowsIdentity]::GetCurrent().Name
+& icacls.exe $data /inheritance:r /grant:r "${user}:(OI)(CI)F" 'SYSTEM:(OI)(CI)F' | Out-Null
+if ($LASTEXITCODE -ne 0) { throw 'Could not secure the per-user configuration directory.' }
+$existingTask = Get-ScheduledTask -TaskName 'OpenCode Deck' -TaskPath '\' -ErrorAction SilentlyContinue
+if ($existingTask -and $existingTask.Description -notlike 'OpenCode Deck*') {
+    throw 'An unrelated task already uses the name OpenCode Deck; refusing to replace it.'
+}
+if ($existingTask) { Stop-ScheduledTask -TaskName 'OpenCode Deck' -TaskPath '\' }
+$venv = Join-Path $data 'venv'
+& $Python -m venv $venv
+if ($LASTEXITCODE -ne 0) { throw 'Virtual environment creation failed.' }
+$runtime = Join-Path $venv 'Scripts\python.exe'
+& $runtime -m pip install --disable-pip-version-check -e $source
+if ($LASTEXITCODE -ne 0) { throw 'Dependency installation failed. Check Internet access and Python architecture.' }
+$install = @{ python=$runtime; source=$source; opencode=$OpenCodePath; pluginMode=$PluginMode }
+$install | ConvertTo-Json | Set-Content -Encoding UTF8 (Join-Path $data 'install.json')
+if (-not (Test-Path (Join-Path $data 'config.json'))) {
+    @{fps=24;brightness=45;animations=$true;ready=$true;serial=$null} | ConvertTo-Json | Set-Content -Encoding UTF8 (Join-Path $data 'config.json')
+}
+$pluginArgs = @('-m','ocdeck','install-plugin','--mode',$PluginMode)
+if ($ConfigDirectory) { $pluginArgs += @('--config-dir',$ConfigDirectory) }
+& $runtime @pluginArgs
+if ($LASTEXITCODE -ne 0) { throw 'Plugin configuration failed. Read the message above; existing config was preserved.' }
+$bin = Join-Path $data 'bin'
+New-Item -ItemType Directory -Force -Path $bin | Out-Null
+$cli = '@echo off' + "`r`n" + '"' + $runtime + '" -m ocdeck %*' + "`r`n"
+$launch = '@echo off' + "`r`n" + '"' + $runtime + '" -m ocdeck launch -- %*' + "`r`n"
+$route = '@echo off' + "`r`n" + '"' + $runtime + '" -m ocdeck route -- %*' + "`r`n"
+Set-Content -LiteralPath (Join-Path $bin 'ocdeck.cmd') -Value $cli -Encoding ASCII
+Set-Content -LiteralPath (Join-Path $bin 'oc.cmd') -Value $launch -Encoding ASCII
+Set-Content -LiteralPath (Join-Path $bin 'opencode.cmd') -Value $route -Encoding ASCII
+$userPath = [Environment]::GetEnvironmentVariable('Path','User')
+$entries = @($userPath -split ';' | Where-Object { $_ -and $_ -ne $bin })
+[Environment]::SetEnvironmentVariable('Path', (($bin + ';' + ($entries -join ';')).TrimEnd(';')), 'User')
+$env:Path = $bin + ';' + $env:Path
+$pythonw = Join-Path $venv 'Scripts\pythonw.exe'
+$action = New-ScheduledTaskAction -Execute $pythonw -Argument '-m ocdeck broker' -WorkingDirectory $data
+$trigger = New-ScheduledTaskTrigger -AtLogOn -User $user
+$principal = New-ScheduledTaskPrincipal -UserId $user -LogonType Interactive -RunLevel Limited
+$settings = New-ScheduledTaskSettingsSet -StartWhenAvailable -MultipleInstances IgnoreNew -RestartCount 999 -RestartInterval (New-TimeSpan -Minutes 1) -ExecutionTimeLimit ([TimeSpan]::Zero) -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries
+Register-ScheduledTask -TaskName 'OpenCode Deck' -TaskPath '\' -Description 'OpenCode Deck animated Mini broker (per-user interactive logon)' -Action $action -Trigger $trigger -Principal $principal -Settings $settings -Force | Out-Null
+Start-ScheduledTask -TaskName 'OpenCode Deck' -TaskPath '\'
+Write-Host ''
+Write-Host 'Installed. Disable this Mini in Elgato Preferences > Devices.'
+Write-Host 'Open a NEW terminal, run: opencode     (or: oc / ocdeck launch)'
+Write-Host 'Verify Get-Command opencode resolves to .opencode-deck\bin\opencode.cmd.'
+Write-Host 'Global plugin also loads for normal opencode launches; managed windows give reliable identity.'
+Write-Host 'Run: ocdeck status     and read docs\FIRST-RUN.md for physical acceptance tests.'
+Write-Host "Keep this bundle directory at: $source"

ocdeck/runtime/scripts/Launch-Agent.bat

@@ -0,0 +1,7 @@
+@echo off
+setlocal
+set "PYTHONPATH=%~dp0..;%PYTHONPATH%"
+set "AGENTDECK_PYTHON=%USERPROFILE%\.opencode-deck\venv\Scripts\python.exe"
+if not exist "%AGENTDECK_PYTHON%" set "AGENTDECK_PYTHON=python"
+"%AGENTDECK_PYTHON%" -m ocdeck start %*
+exit /b %ERRORLEVEL%

ocdeck/runtime/scripts/Launch-Claude.bat

@@ -0,0 +1,7 @@
+@echo off
+setlocal
+set "PYTHONPATH=%~dp0..;%PYTHONPATH%"
+set "AGENTDECK_PYTHON=%USERPROFILE%\.opencode-deck\venv\Scripts\python.exe"
+if not exist "%AGENTDECK_PYTHON%" set "AGENTDECK_PYTHON=python"
+"%AGENTDECK_PYTHON%" -m ocdeck harness-launch --profile claude -- %*
+exit /b %ERRORLEVEL%

ocdeck/runtime/scripts/Launch-Codex.bat

@@ -0,0 +1,7 @@
+@echo off
+setlocal
+set "PYTHONPATH=%~dp0..;%PYTHONPATH%"
+set "AGENTDECK_PYTHON=%USERPROFILE%\.opencode-deck\venv\Scripts\python.exe"
+if not exist "%AGENTDECK_PYTHON%" set "AGENTDECK_PYTHON=python"
+"%AGENTDECK_PYTHON%" -m ocdeck harness-launch --profile codex -- %*
+exit /b %ERRORLEVEL%

ocdeck/runtime/scripts/Launch-Copilot-VSCode.bat

@@ -0,0 +1,7 @@
+@echo off
+setlocal
+set "PYTHONPATH=%~dp0..;%PYTHONPATH%"
+set "AGENTDECK_PYTHON=%USERPROFILE%\.opencode-deck\venv\Scripts\python.exe"
+if not exist "%AGENTDECK_PYTHON%" set "AGENTDECK_PYTHON=python"
+"%AGENTDECK_PYTHON%" -m ocdeck harness-launch --profile copilot-vscode -- %*
+exit /b %ERRORLEVEL%

ocdeck/runtime/scripts/Launch-Copilot.bat

@@ -0,0 +1,7 @@
+@echo off
+setlocal
+set "PYTHONPATH=%~dp0..;%PYTHONPATH%"
+set "AGENTDECK_PYTHON=%USERPROFILE%\.opencode-deck\venv\Scripts\python.exe"
+if not exist "%AGENTDECK_PYTHON%" set "AGENTDECK_PYTHON=python"
+"%AGENTDECK_PYTHON%" -m ocdeck harness-launch --profile copilot-cli -- %*
+exit /b %ERRORLEVEL%

ocdeck/runtime/scripts/Launch-Cursor.bat

@@ -0,0 +1,7 @@
+@echo off
+setlocal
+set "PYTHONPATH=%~dp0..;%PYTHONPATH%"
+set "AGENTDECK_PYTHON=%USERPROFILE%\.opencode-deck\venv\Scripts\python.exe"
+if not exist "%AGENTDECK_PYTHON%" set "AGENTDECK_PYTHON=python"
+"%AGENTDECK_PYTHON%" -m ocdeck harness-launch --profile cursor -- %*
+exit /b %ERRORLEVEL%

ocdeck/runtime/scripts/Launch-Gemini.bat

@@ -0,0 +1,7 @@
+@echo off
+setlocal
+set "PYTHONPATH=%~dp0..;%PYTHONPATH%"
+set "AGENTDECK_PYTHON=%USERPROFILE%\.opencode-deck\venv\Scripts\python.exe"
+if not exist "%AGENTDECK_PYTHON%" set "AGENTDECK_PYTHON=python"
+"%AGENTDECK_PYTHON%" -m ocdeck harness-launch --profile gemini -- %*
+exit /b %ERRORLEVEL%

ocdeck/runtime/scripts/Remove-Integration.ps1

@@ -0,0 +1,35 @@
+param([Parameter(Mandatory=$true)][string]$Data)
+$ErrorActionPreference = 'Stop'
+$task = Get-ScheduledTask -TaskName 'OpenCode Deck' -TaskPath '\' -ErrorAction SilentlyContinue
+if ($task) {
+    if ($task.Description -notlike 'OpenCode Deck*') { throw 'Unrelated scheduled task; refusing removal.' }
+    Stop-ScheduledTask -TaskName 'OpenCode Deck' -TaskPath '\'
+    Unregister-ScheduledTask -TaskName 'OpenCode Deck' -TaskPath '\' -Confirm:$false
+}
+$env:OCDECK_HOME = $Data
+
+$metadata = Join-Path $Data 'install.json'
+if (Test-Path -LiteralPath $metadata) {
+    $install = Get-Content -LiteralPath $metadata -Raw | ConvertFrom-Json
+    if ($install.configDir) {
+        $entry = Join-Path $install.configDir 'plugins\ocdeck.js'
+        if ((Test-Path -LiteralPath $entry) -and (Get-Content -LiteralPath $entry -Raw).StartsWith('// Managed by OpenCode Deck installer')) {
+            Move-Item -LiteralPath $entry -Destination ($entry + '.agentdeck-backup-' + [DateTime]::UtcNow.Ticks)
+        }
+        $tui = Join-Path $install.configDir 'tui.json'
+        if ((Test-Path -LiteralPath $tui) -and $install.source) {
+            $config = Get-Content -LiteralPath $tui -Raw | ConvertFrom-Json
+            $uri = ([System.Uri](Join-Path $install.source 'plugins\tui.mjs')).AbsoluteUri
+            if ($config.plugin -contains $uri) {
+                Copy-Item -LiteralPath $tui -Destination ($tui + '.agentdeck-backup-' + [DateTime]::UtcNow.Ticks)
+                $config.plugin = @($config.plugin | Where-Object { $_ -ne $uri })
+                $config | ConvertTo-Json -Depth 100 | Set-Content -LiteralPath $tui -Encoding UTF8
+            }
+        }
+    }
+}
+$bin = Join-Path $Data 'bin'
+$entries = @([Environment]::GetEnvironmentVariable('Path','User') -split ';' | Where-Object { $_ -and $_ -ne $bin })
+[Environment]::SetEnvironmentVariable('Path', ($entries -join ';'), 'User')
+
+Remove-Item -LiteralPath 'HKCU:\Software\Classes\AppUserModelId\AgentDeck' -ErrorAction SilentlyContinue

ocdeck/runtime/scripts/Run-OpenCode.ps1

@@ -0,0 +1,7 @@
+param([Parameter(Mandatory=$true)][string]$LaunchFile)
+$ErrorActionPreference = 'Stop'
+$spec = Get-Content -LiteralPath $LaunchFile -Raw | ConvertFrom-Json
+Set-Location -LiteralPath $spec.cwd
+$arguments = @($spec.args)
+& $spec.executable @arguments
+exit $LASTEXITCODE

ocdeck/runtime/scripts/Test.ps1

@@ -0,0 +1,11 @@
+$ErrorActionPreference = 'Stop'
+$source = Split-Path -Parent $PSScriptRoot
+$runtime = Join-Path $env:USERPROFILE '.opencode-deck\venv\Scripts\python.exe'
+if (-not (Test-Path $runtime)) { $runtime = 'python' }
+Push-Location $source
+try {
+    & $runtime -m unittest discover -s tests -v
+    if ($LASTEXITCODE -ne 0) { throw 'Python/integration tests failed' }
+    & node --test tests/facts.test.mjs tests/harnesses.test.mjs tests/next.test.mjs
+    if ($LASTEXITCODE -ne 0) { throw 'JavaScript tests failed' }
+} finally { Pop-Location }

ocdeck/runtime/scripts/Uninstall.ps1

@@ -0,0 +1,11 @@
+param([switch]$DryRun, [string[]]$Scan = @())
+$ErrorActionPreference = 'Stop'
+$data = if ($env:OCDECK_HOME) { $env:OCDECK_HOME } else { Join-Path $env:USERPROFILE '.opencode-deck' }
+$metadata = Join-Path $data 'install.json'
+if (-not (Test-Path -LiteralPath $metadata)) { throw 'No installation metadata. Run ocdeck uninstall --all from the installed Python environment.' }
+$install = Get-Content -LiteralPath $metadata -Raw | ConvertFrom-Json
+$argsList = @('-m','ocdeck','uninstall','--all')
+if ($DryRun) { $argsList += '--dry-run' }
+foreach ($directory in $Scan) { $argsList += @('--scan', $directory) }
+& $install.python @argsList
+exit $LASTEXITCODE

ocdeck/runtime/scripts/Verify-Windows.ps1

@@ -0,0 +1,13 @@
+$ErrorActionPreference = 'Stop'
+$data = Join-Path $env:USERPROFILE '.opencode-deck'
+$runtime = Join-Path $data 'venv\Scripts\python.exe'
+Write-Host 'Command resolution:'
+Get-Command opencode,oc,ocdeck -ErrorAction SilentlyContinue | Select-Object Name,Source
+Write-Host 'Scheduled task at root:'
+Get-ScheduledTask -TaskName 'OpenCode Deck' -TaskPath '\' | Select-Object TaskName,TaskPath,State
+Get-ScheduledTaskInfo -TaskName 'OpenCode Deck' -TaskPath '\' | Select-Object LastRunTime,LastTaskResult
+Write-Host 'Native device inventory:'
+& $runtime -m ocdeck devices
+Write-Host 'Broker status (mock must be false on your PC):'
+& $runtime -m ocdeck status
+Write-Host 'These checks do not prove physical imagery or keyboard focus. Follow FIRST-RUN.md.'

ocdeck/runtime/scripts/check-js.py

@@ -0,0 +1,8 @@
+"""Check every pre-commit input; node --check accepts only one source file."""
+import subprocess
+import sys
+
+for filename in sys.argv[1:]:
+    result = subprocess.run(['node', '--check', filename])
+    if result.returncode:
+        raise SystemExit(result.returncode)

ocdeck/runtime/scripts/examples/Claude-Cloud.bat

@@ -0,0 +1,6 @@
+@echo off
+setlocal
+REM Use normal Anthropic login/API-key settings, without inherited local routing.
+for %%V in (ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL ANTHROPIC_DEFAULT_OPUS_MODEL ANTHROPIC_DEFAULT_SONNET_MODEL ANTHROPIC_DEFAULT_HAIKU_MODEL ANTHROPIC_DEFAULT_FABLE_MODEL CLAUDE_CODE_SUBAGENT_MODEL ANTHROPIC_CUSTOM_MODEL_OPTION ANTHROPIC_CUSTOM_MODEL_OPTION_NAME CLAUDE_CODE_USE_BEDROCK CLAUDE_CODE_USE_VERTEX CLAUDE_CODE_USE_FOUNDRY) do set "%%V="
+call "%~dp0..\Launch-Agent.bat" --profile claude -- %*
+exit /b %ERRORLEVEL%

ocdeck/runtime/scripts/examples/Claude-Local.bat

@@ -0,0 +1,21 @@
+@echo off
+setlocal
+if not defined AGENTDECK_LOCAL_URL (
+    echo Set AGENTDECK_LOCAL_URL to the Anthropic-compatible server base URL.
+    exit /b 2
+)
+if not defined AGENTDECK_LOCAL_MODEL (
+    echo Set AGENTDECK_LOCAL_MODEL to the model ID served by that endpoint.
+    exit /b 2
+)
+set "ANTHROPIC_BASE_URL=%AGENTDECK_LOCAL_URL%"
+set "ANTHROPIC_API_KEY="
+set "ANTHROPIC_AUTH_TOKEN=%AGENTDECK_LOCAL_TOKEN%"
+if not defined ANTHROPIC_AUTH_TOKEN set "ANTHROPIC_AUTH_TOKEN=local-dev"
+set "ANTHROPIC_MODEL=%AGENTDECK_LOCAL_MODEL%"
+set "ANTHROPIC_DEFAULT_OPUS_MODEL=%AGENTDECK_LOCAL_MODEL%"
+set "ANTHROPIC_DEFAULT_SONNET_MODEL=%AGENTDECK_LOCAL_MODEL%"
+set "ANTHROPIC_DEFAULT_HAIKU_MODEL=%AGENTDECK_LOCAL_MODEL%"
+set "CLAUDE_CODE_SUBAGENT_MODEL=%AGENTDECK_LOCAL_MODEL%"
+call "%~dp0..\Launch-Agent.bat" --profile claude -- --model "%AGENTDECK_LOCAL_MODEL%" %*
+exit /b %ERRORLEVEL%

ocdeck/runtime/scripts/examples/HomeAILab-Claude-5090.bat

@@ -0,0 +1,8 @@
+@echo off
+setlocal
+if not defined HOMEAILAB_ROOT (
+    echo Set HOMEAILAB_ROOT to the HomeAILab checkout directory first.
+    exit /b 2
+)
+call "%~dp0..\Launch-Agent.bat" --profile claude --launcher "%HOMEAILAB_ROOT%\harness\claude\claude-5090.bat" -- %*
+exit /b %ERRORLEVEL%

ocdeck/runtime/scripts/examples/HomeAILab-Claude-Cluster.bat

@@ -0,0 +1,8 @@
+@echo off
+setlocal
+if not defined HOMEAILAB_ROOT (
+    echo Set HOMEAILAB_ROOT to the HomeAILab checkout directory first.
+    exit /b 2
+)
+call "%~dp0..\Launch-Agent.bat" --profile claude --launcher "%HOMEAILAB_ROOT%\harness\claude\claude-cluster.bat" -- %*
+exit /b %ERRORLEVEL%

ocdeck/runtime/scripts/examples/HomeAILab-OpenCode-5090.bat

@@ -0,0 +1,8 @@
+@echo off
+setlocal
+if not defined HOMEAILAB_ROOT (
+    echo Set HOMEAILAB_ROOT to the HomeAILab checkout directory first.
+    exit /b 2
+)
+call "%~dp0..\Launch-Agent.bat" --profile opencode --launcher "%HOMEAILAB_ROOT%\harness\opencode\opencode-5090.bat" -- %*
+exit /b %ERRORLEVEL%

ocdeck/runtime/scripts/examples/HomeAILab-OpenCode-Spark.bat

@@ -0,0 +1,8 @@
+@echo off
+setlocal
+if not defined HOMEAILAB_ROOT (
+    echo Set HOMEAILAB_ROOT to the HomeAILab checkout directory first.
+    exit /b 2
+)
+call "%~dp0..\Launch-Agent.bat" --profile opencode --launcher "%HOMEAILAB_ROOT%\harness\opencode\opencode-spark.bat" -- %*
+exit /b %ERRORLEVEL%