Import AITURK IDE 1.0.0-beta.1 from Hermes 63279301; preserve MIT license

This commit is contained in:
2026-09-05 13:26:46 +03:00
commit 03634b1ca3
11340 changed files with 3442369 additions and 0 deletions
+771
View File
@@ -0,0 +1,771 @@
import type { BillingBlock, UsageModelData } from '@hermes/shared/billing'
import type { HermesSkin } from '@hermes/shared/skin'
import type { SessionInfo, SlashCategory, SubagentStatus, Usage } from './types.js'
/** The cross-surface skin contract (canonical shape in `@hermes/shared`).
* Includes the paired light_colors/dark_colors overlays from #20379. */
export type GatewaySkin = HermesSkin
export interface GatewayCompletionItem {
display: string
/** Completion class, set by the gateway. `skill` covers skill commands and
* skill bundles — the only kind offered for an inline `/skill` reference. */
kind?: string
meta?: string
text: string
}
export interface GatewayTranscriptMessage {
context?: string
display_kind?: string
display_metadata?: Record<string, unknown>
name?: string
role: 'assistant' | 'system' | 'tool' | 'user'
text?: string
}
// ── Commands / completion ────────────────────────────────────────────
export interface CommandsCatalogResponse {
canon?: Record<string, string>
categories?: SlashCategory[]
pairs?: [string, string][]
skill_count?: number
sub?: Record<string, string[]>
warning?: string
}
export interface CompletionResponse {
items?: GatewayCompletionItem[]
replace_from?: number
}
export interface SlashExecResponse {
output?: string
warning?: string
}
// ── Remote Spending (Phase 2b) ───────────────────────────────────────
// Wire shapes now live in @hermes/shared for reuse by TypeScript clients.
export type {
BillingAutoReload,
BillingBlock,
BillingCardInfo,
BillingChargeResponse,
BillingChargeStatusResponse,
BillingErrorPayload,
BillingMonthlyCap,
BillingMutationResponse,
BillingStateResponse,
SubscriptionPreviewResponse,
SubscriptionStateResponse,
SubscriptionTierOption,
SubscriptionUpgradeResponse,
UsageBarData,
UsageModelData
} from '@hermes/shared/billing'
export type CommandDispatchResponse =
| { output?: string; type: 'exec' | 'plugin' }
| { target: string; type: 'alias' }
| { display?: string; message?: string; name: string; type: 'skill' }
| { display?: string; message: string; notice?: string; type: 'send' }
| { message: string; notice?: string; type: 'prefill' }
// ── Config ───────────────────────────────────────────────────────────
export interface ConfigDisplayConfig {
battery?: boolean
bell_on_complete?: boolean
bell_on_prompt?: boolean
busy_input_mode?: string
details_mode?: string
/** Focus view (/focus) — display-only reduced-output mode. */
focus_view?: boolean
inline_diffs?: boolean
mouse_tracking?: boolean | null | number | string
sections?: Record<string, string>
show_cost?: boolean
show_reasoning?: boolean
/** CLI/TUI status-bar field visibility filter (shared with the classic
* CLI bar — see display.status_bar.fields in configuration docs).
* Raw YAML: callers must runtime-validate entries. */
status_bar?: { fields?: unknown }
streaming?: boolean
thinking_mode?: string
/** Show [HH:MM] timestamps on transcript rows — same key the classic CLI
* honors on its user/assistant labels (#41531). */
timestamps?: boolean
/**
* Nudge the user toward the /agents spawn-tree dashboard the first time a
* turn starts delegating, via a one-time transient activity hint. Opens
* nothing — just advertises the command. Default true.
*/
tui_agents_nudge?: boolean
tui_auto_resume_recent?: boolean
tui_compact?: boolean
/** Legacy alias for display.mouse_tracking. */
tui_mouse?: boolean | null | number | string
// Forward-compat: backend may send styles this client doesn't know yet —
// `normalizeIndicatorStyle` falls back to 'kaomoji' for those — but the
// wire type is documented as `string` so consumers don't get a false
// narrowing-and-autocomplete contract on a value that requires runtime
// validation anyway.
tui_status_indicator?: string
tui_statusbar?: 'bottom' | 'off' | 'on' | 'top' | boolean
/** Theme mode pin: 'light' / 'dark' beat background auto-detection; 'auto'
* (default) trusts the OSC-11 probe + env signals. */
tui_theme?: string
}
export interface ConfigVoiceConfig {
// Raw `yaml.safe_load()` values from config may be non-string if hand-edited.
// Callers must normalize/validate at runtime.
record_key?: unknown
submit_mode?: unknown
}
export interface ConfigApprovalsConfig {
// Raw config value: only the explicit boolean false disables the safety gate.
destructive_slash_confirm?: unknown
}
export interface ConfigFullResponse {
config?: {
approvals?: ConfigApprovalsConfig
display?: ConfigDisplayConfig
voice?: ConfigVoiceConfig
paste_collapse_threshold?: number
paste_collapse_char_threshold?: number
}
}
export interface ConfigMtimeResponse {
/** Revision hash of MCP-relevant config sections; reload MCP only when it
* changes (cosmetic writes like /skin must not trigger reconnects). */
mcp_rev?: string
mtime?: number
}
export interface ConfigGetValueResponse {
display?: string
home?: string
value?: string
}
export interface ConfigSetResponse {
confirm_message?: string
confirm_required?: boolean
credential_warning?: string
// A model pick made mid-turn is queued and applied at the next turn start,
// not live yet — the handler says "next turn" instead of "model → X".
deferred?: boolean
history_reset?: boolean
info?: SessionInfo
value?: string
warning?: string
}
export interface SetupStatusResponse {
provider_configured?: boolean
}
export interface SystemBatteryResponse {
available?: boolean
category?: string
percent?: null | number
plugged?: null | boolean
}
// ── Session lifecycle ────────────────────────────────────────────────
export interface SessionCreateResponse {
info?: SessionInfo & { config_warning?: string; credential_warning?: string }
session_id: string
}
export interface SessionResumeResponse {
inflight?: null | SessionInflightTurn
info?: SessionInfo
message_count?: number
messages: GatewayTranscriptMessage[]
resumed?: string
running?: boolean
session_id: string
started_at?: number
status?: LiveSessionStatus
}
export type LiveSessionStatus = 'idle' | 'starting' | 'waiting' | 'working'
export interface SessionActiveItem {
current?: boolean
id: string
last_active?: number
message_count?: number
model?: string
preview?: string
session_key?: string
started_at?: number
status: LiveSessionStatus
title?: string
}
export interface SessionActiveListResponse {
sessions?: SessionActiveItem[]
}
export interface SessionInflightTurn {
assistant?: string
streaming?: boolean
user?: string
}
export interface SessionActivateResponse {
inflight?: null | SessionInflightTurn
info?: SessionInfo
message_count?: number
messages: GatewayTranscriptMessage[]
running?: boolean
session_id: string
session_key?: string
started_at?: number
status?: LiveSessionStatus
}
export interface SessionListItem {
id: string
message_count: number
preview: string
source?: string
started_at: number
title: string
}
export interface SessionListResponse {
sessions?: SessionListItem[]
}
export interface SessionDeleteResponse {
deleted: string
}
export interface SessionMostRecentResponse {
session_id?: null | string
source?: string
started_at?: number
title?: string
}
export interface SessionTitleResponse {
pending?: boolean
session_key?: string
title?: string
}
export interface SessionSaveResponse {
file?: string
}
export interface SessionUndoResponse {
removed?: number
}
export interface SessionUsageResponse {
active_subagents?: number
avg_latency_s?: number
avg_tps?: number
cache_hit_pct?: number
cache_read?: number
cache_write?: number
calls?: number
compressions?: number
context_max?: number
context_percent?: number
context_used?: number
cost_status?: 'estimated' | 'exact'
cost_usd?: number
credits_lines?: string[]
input?: number
model?: string
output?: number
total?: number
// Shared dollar usage model (two-bar view) so /usage renders the same bars
// as /subscription. Dollars only — never "credits".
usage?: UsageModelData
}
export interface SessionStatusResponse {
output?: string
}
export interface SessionCompressResponse {
after_messages?: number
after_tokens?: number
before_messages?: number
before_tokens?: number
info?: SessionInfo
messages?: GatewayTranscriptMessage[]
removed?: number
summary?: {
headline?: string
noop?: boolean
note?: null | string
token_line?: string
}
usage?: Usage
}
export interface SessionBranchResponse {
session_id?: string
title?: string
}
export interface SessionCloseResponse {
closed?: boolean
ok?: boolean
}
export interface SessionInterruptResponse {
ok?: boolean
}
export interface SessionSteerResponse {
status?: 'queued' | 'rejected'
text?: string
}
// ── Prompt / submission ──────────────────────────────────────────────
export interface PromptSubmitResponse {
ok?: boolean
/** Set when the submitted text was a bare voice stop phrase consumed
* server-side to end the voice chat instead of starting a turn. */
voice_stopped?: boolean
}
export interface BackgroundStartResponse {
task_id?: string
}
export interface ClarifyRespondResponse {
ok?: boolean
}
export interface ApprovalRespondResponse {
ok?: boolean
}
export interface SudoRespondResponse {
ok?: boolean
}
export interface SecretRespondResponse {
ok?: boolean
}
// ── Shell / clipboard / input ────────────────────────────────────────
export interface ShellExecResponse {
code: number
stderr?: string
stdout?: string
}
export interface ClipboardPasteResponse {
attached?: boolean
count?: number
height?: number
message?: string
token_estimate?: number
width?: number
}
export interface InputDetectDropResponse {
height?: number
is_image?: boolean
matched?: boolean
name?: string
text?: string
token_estimate?: number
width?: number
}
export interface TerminalResizeResponse {
ok?: boolean
}
// ── Image attach ─────────────────────────────────────────────────────
export interface ImageAttachResponse {
height?: number
name?: string
remainder?: string
token_estimate?: number
width?: number
}
// ── Voice ────────────────────────────────────────────────────────────
export interface VoiceToggleResponse {
audio_available?: boolean
available?: boolean
details?: string
enabled?: boolean
record_key?: string
stop_hint?: string
stt_available?: boolean
tts?: boolean
}
export interface VoiceRecordResponse {
status?: 'busy' | 'recording' | 'stopped'
text?: string
}
// ── Wake word ────────────────────────────────────────────────────────
export interface WakeStartResponse {
enabled_persisted?: boolean
hint?: string
owner_surface?: null | string
phrase?: string
provider?: string
reason?: string
started?: boolean
}
export interface WakeStopResponse {
disabled_persisted?: boolean
reason?: null | string
stopped?: boolean
}
export interface WakeStatusResponse {
/** Armed but the mic delivers only silence (macOS backend-permission gap). */
audio_silent?: boolean
available?: boolean
/** Config truth (wake_word.enabled). */
enabled?: boolean
hint?: string
listening?: boolean
owned_by_caller?: boolean
owner_surface?: null | string
phrase?: string
provider?: string
}
// ── Tools (TS keeps configure since it resets local history) ─────────
export interface ToolsConfigureResponse {
changed?: string[]
enabled_toolsets?: string[]
info?: SessionInfo
missing_servers?: string[]
reset?: boolean
unknown?: string[]
}
// ── Model picker ─────────────────────────────────────────────────────
export interface ModelOptionProvider {
auth_type?: string
authenticated?: boolean
is_current?: boolean
key_env?: string
models?: string[]
name: string
slug: string
total_models?: number
warning?: string
}
export interface ModelOptionsResponse {
model?: string
provider?: string
providers?: ModelOptionProvider[]
}
// ── MCP ──────────────────────────────────────────────────────────────
export interface ReloadMcpResponse {
status?: string
message?: string
/** The mcp_rev the server actually loaded (re-hashed after discovery).
* The client records THIS as its accepted revision, not the one it
* requested — a reload that raced a config edit reports the newer rev. */
loaded_rev?: string
}
export interface ReloadEnvResponse {
updated?: number
}
export interface ProcessStopResponse {
killed?: number
}
export interface BrowserManageResponse {
connected?: boolean
messages?: string[]
url?: string
}
export interface RollbackCheckpoint {
hash: string
message?: string
timestamp?: string
}
export interface RollbackListResponse {
checkpoints?: RollbackCheckpoint[]
enabled?: boolean
}
export interface RollbackDiffResponse {
diff?: string
rendered?: string
stat?: string
}
export interface RollbackRestoreResponse {
error?: string
history_removed?: number
message?: string
reason?: string
restored_to?: string
success?: boolean
}
// ── Subagent events ──────────────────────────────────────────────────
export interface SubagentEventPayload {
api_calls?: number
cost_usd?: number
/** Batch (delegation) id this subagent belongs to — distinguishes
* interleaved `[n/N]` progress from concurrent or nested fan-outs. */
delegation_id?: string
depth?: number
duration_seconds?: number
files_read?: string[]
files_written?: string[]
goal: string
input_tokens?: number
iteration?: number
model?: string
output_tail?: { is_error?: boolean; preview?: string; tool?: string }[]
output_tokens?: number
parent_id?: null | string
reasoning_tokens?: number
status?: SubagentStatus
subagent_id?: string
summary?: string
task_count?: number
task_index: number
text?: string
tool_count?: number
tool_name?: string
tool_preview?: string
toolsets?: string[]
}
// ── Delegation control RPCs ──────────────────────────────────────────
export interface DelegationStatusResponse {
active?: {
depth?: number
goal?: string
model?: null | string
parent_id?: null | string
started_at?: number
status?: string
subagent_id?: string
tool_count?: number
}[]
max_concurrent_children?: number
max_spawn_depth?: number
paused?: boolean
}
export interface DelegationPauseResponse {
paused?: boolean
}
export interface SubagentInterruptResponse {
found?: boolean
subagent_id?: string
}
// ── Spawn-tree snapshots ─────────────────────────────────────────────
export interface SpawnTreeListEntry {
count: number
finished_at?: number
label?: string
path: string
session_id?: string
started_at?: number | null
}
export interface SpawnTreeListResponse {
entries?: SpawnTreeListEntry[]
}
export interface SpawnTreeLoadResponse {
finished_at?: number
label?: string
session_id?: string
started_at?: null | number
subagents?: unknown[]
}
export type GatewayEvent =
| { payload?: { heartbeat?: boolean; skin?: GatewaySkin }; session_id?: string; type: 'gateway.ready' }
| { payload?: GatewaySkin; session_id?: string; type: 'skin.changed' }
| { payload: SessionInfo; session_id?: string; type: 'session.info' }
| { payload?: { text?: string }; session_id?: string; type: 'thinking.delta' }
| { payload?: { kind?: string }; session_id?: string; type: 'reaction' }
| { payload?: undefined; session_id?: string; type: 'message.start' }
| { payload?: { kind?: string; text?: string }; session_id?: string; type: 'status.update' }
| {
payload?: {
id?: string
key?: string
kind?: 'sticky' | 'ttl'
level?: 'error' | 'info' | 'success' | 'warn'
text?: string
ttl_ms?: null | number
}
session_id?: string
type: 'notification.show'
}
| { payload?: { key?: string }; session_id?: string; type: 'notification.clear' }
| {
payload: { user_code?: string; verification_url: string }
session_id?: string
type: 'billing.step_up.verification'
}
| { payload?: { state?: 'idle' | 'listening' | 'transcribing' }; session_id?: string; type: 'voice.status' }
| {
payload?: { no_speech_limit?: boolean; stop_phrase?: boolean; text?: string; typed?: boolean }
session_id?: string
type: 'voice.transcript'
}
| {
payload?: { phrase?: string; profile?: null | string; start_new_session?: boolean }
session_id?: string
type: 'wake.detected'
}
| { payload?: { reason?: string }; session_id?: string; type: 'dashboard.new_session_requested' }
| { payload: { line: string }; session_id?: string; type: 'gateway.stderr' }
| { payload?: { attempt?: number; delay_ms?: number }; session_id?: string; type: 'gateway.reconnecting' }
| {
payload?: { level?: 'info' | 'warn' | 'error'; message?: string }
session_id?: string
type: 'browser.progress'
}
| {
payload?: { cwd?: string; python?: string; stderr_tail?: string }
session_id?: string
type: 'gateway.start_timeout'
}
| { payload?: { preview?: string }; session_id?: string; type: 'gateway.protocol_error' }
| {
payload?: { text?: string; verbose?: boolean }
session_id?: string
type: 'reasoning.delta' | 'reasoning.available'
}
| {
payload: { count?: number; index?: number; label?: string; text?: string }
session_id?: string
type: 'moa.reference'
}
| { payload?: { aggregator?: string }; session_id?: string; type: 'moa.aggregating' }
| {
payload?: { label?: string; refs_done?: number; refs_total?: number }
session_id?: string
type: 'moa.progress'
}
| {
payload?: { aggregator?: string; phase?: string; refs_done?: number; refs_total?: number }
session_id?: string
type: 'moa.phase'
}
| { payload: { name?: string; preview?: string }; session_id?: string; type: 'tool.progress' }
| { payload: { name?: string }; session_id?: string; type: 'tool.generating' }
| {
payload: { args_text?: string; context?: string; name?: string; tool_id: string; todos?: unknown[] }
session_id?: string
type: 'tool.start'
}
| {
payload: {
duration_s?: number
error?: string
inline_diff?: string
name?: string
result_text?: string
summary?: string
tool_id: string
todos?: unknown[]
}
session_id?: string
type: 'tool.complete'
}
| {
payload: {
answers?: Record<string, string>
choices?: string[] | null
question?: string
questions?: { choices?: string[] | null; multi_select?: boolean; qid: string; question: string }[]
request_id: string
}
session_id?: string
type: 'clarify.request'
}
| {
payload: {
allow_permanent?: boolean
choices?: string[]
command: string
description: string
smart_denied?: boolean
}
session_id?: string
type: 'approval.request'
}
| { payload: { request_id: string }; session_id?: string; type: 'sudo.request' }
| { payload: { env_var: string; prompt: string; request_id: string }; session_id?: string; type: 'secret.request' }
| { payload: { request_id: string }; session_id?: string; type: 'secret.expire' | 'sudo.expire' }
| { payload: { task_id: string; text: string }; session_id?: string; type: 'background.complete' }
| { payload: { question?: string; task_id: string; text: string }; session_id?: string; type: 'btw.complete' }
| { payload?: { text?: string }; session_id?: string; type: 'review.summary' }
| { payload: SubagentEventPayload; session_id?: string; type: 'subagent.spawn_requested' }
| { payload: SubagentEventPayload; session_id?: string; type: 'subagent.start' }
| { payload: SubagentEventPayload; session_id?: string; type: 'subagent.thinking' }
| { payload: SubagentEventPayload; session_id?: string; type: 'subagent.tool' }
| { payload: SubagentEventPayload; session_id?: string; type: 'subagent.progress' }
| { payload: SubagentEventPayload; session_id?: string; type: 'subagent.complete' }
| { payload: { rendered?: string; text?: string }; session_id?: string; type: 'message.delta' }
| {
payload: { already_streamed?: boolean; text: string }
session_id?: string
type: 'message.interim'
}
| {
payload?: {
billing?: BillingBlock
failure_reason?: string
reasoning?: string
rendered?: string
response_previewed?: boolean
text?: string
usage?: Usage
}
session_id?: string
type: 'message.complete'
}
| { payload?: { usage?: Usage }; session_id?: string; type: 'session.usage' }
| { payload?: { message?: string }; session_id?: string; type: 'error' }