@quantiya/codevibe-core 2.0.0 → 2.0.1

package/dist/companion-mode/index.d.ts

@@ -0,0 +1,55 @@
+import { DetectableAgent } from '../orchestration/detect-agents';
+import type { ShellEventEmit } from '../orchestration-shell/emit-shell-event';
+import type { Session } from '../types';
+export declare class NoAgentInstalledError extends Error {
+    constructor(message: string);
+}
+export interface CompanionArgs {
+    /** Optional `--agent <kind>` CLI override. */
+    agent?: DetectableAgent;
+    /** Args to pass through to the agent wrapper. */
+    passthrough: string[];
+    /** When set, clears the persisted preference before resolving. */
+    forgetAgent?: boolean;
+    /**
+     * Session context for §3 emitShellEvent fan-out. When provided
+     * together with `emitter`, MODE_SELECTED is emitted before the exec
+     * handoff. When either is omitted, the emit is skipped — Companion
+     * Mode is functional without it because the cohort flag gates every
+     * emit anyway (CP-1.a default OFF). Per Stage 1 r1 HIGH-3.
+     */
+    session?: Session;
+    /**
+     * Bound emitter (typically `createShellEventEmitter(appsyncClient)`).
+     * Required for the MODE_SELECTED emit when `session` is also set.
+     */
+    emitter?: (args: ShellEventEmit) => Promise<void>;
+    /** Test seam — override the `execFileSync` handoff. */
+    execFile?: (binPath: string, args: string[], options: {
+        stdio: 'inherit';
+    }) => void;
+    /** Test seam — override `detectInstalledAgents`. */
+    detect?: () => DetectableAgent[];
+    /** Test seam — override bin-path resolver (real impl uses `command -v`). */
+    resolveBinPath?: (kind: DetectableAgent) => string | null;
+    /**
+     * Test seam — override the `<wrapper> --version` 2s health-probe
+     * (§4 line 280). Real impl spawns the wrapper with a SIGKILL on
+     * timeout. Per Stage 2 r1 Codex MEDIUM-2.
+     */
+    versionProbe?: (binPath: string) => Promise<boolean>;
+}
+/**
+ * §4 LOCK lines 232-273. Detect → resolve → persist → exec.
+ *
+ * On a TTY with multiple agents, this calls `pickAgent` for the
+ * interactive readline picker. The function does NOT mount the Ink
+ * TUI — Companion Mode does not need it (the picker hands terminal
+ * control directly to the wrapper).
+ *
+ * NOTE: the function returns when the test seam `execFile` is
+ * provided; in production the `execFileSync` call replaces the process
+ * (`stdio: 'inherit'`) so `process.exit(0)` is unreachable but kept
+ * as a defensive fallback (§4 line 273).
+ */
+export declare function runCompanionMode(args: CompanionArgs): Promise<void>;

package/dist/companion-mode/persist-preference.d.ts

@@ -0,0 +1,24 @@
+export declare function companionPreferenceFilePath(): string;
+export interface CompanionPreference {
+    lastAgent: 'CLAUDE' | 'GEMINI' | 'CODEX';
+    lastUsedAt: string;
+}
+/**
+ * §4 lines 304-316 LOCK. Reads + validates the preference file.
+ * Returns `null` on every failure mode named in the design:
+ *   - file missing
+ *   - loose permissions (any group/world bits set)
+ *   - malformed JSON
+ *   - schema mismatch
+ */
+export declare function readCompanionPreference(): Promise<CompanionPreference | null>;
+/**
+ * Writes the preference file with mode 0600. Creates parent dir if
+ * missing. Self-heals loose perms (writes 0o600 explicitly on every
+ * write).
+ */
+export declare function persistCompanionPreference(pref: CompanionPreference): Promise<void>;
+/**
+ * Clears the preference file (used by `--forget-agent` flag per §4).
+ */
+export declare function clearCompanionPreference(): Promise<void>;

package/dist/companion-mode/resolve-agent.d.ts

@@ -0,0 +1,41 @@
+import { DetectableAgent } from '../orchestration/detect-agents';
+export interface DetectedAgent {
+    kind: DetectableAgent;
+    binPath: string;
+    healthy: boolean;
+}
+export interface ResolveAgentArgs {
+    /** Healthy agents detected on PATH. */
+    healthy: DetectedAgent[];
+    /** `--agent` CLI flag override (if any). */
+    flag?: DetectableAgent;
+    /** Persisted preference from `readCompanionPreference()` (if any). */
+    preferred?: DetectableAgent;
+}
+export interface ResolveAgentResult {
+    /** When a single resolved agent exists. */
+    agent?: DetectedAgent;
+    /** When multiple healthy agents exist and the picker should run. */
+    needsPicker?: {
+        healthy: DetectedAgent[];
+        defaultIndex: number;
+    };
+    /** When the flag asked for an agent that's not healthy. */
+    flagMissing?: {
+        requested: DetectableAgent;
+    };
+}
+/**
+ * §4 resolution order LOCK:
+ *   1. flag > preference > picker > single-agent fast-path
+ *
+ *   - If `flag` is set and a matching healthy agent exists → return it.
+ *   - If `flag` is set and no matching healthy agent → `flagMissing`.
+ *   - Single-agent fast-path: exactly 1 healthy agent → return it
+ *     (regardless of preference).
+ *   - Multiple healthy + `preferred` set + matches → picker with that
+ *     row pre-selected (caller may decide to auto-accept).
+ *   - Multiple healthy + no preference → picker with first row
+ *     pre-selected.
+ */
+export declare function resolveAgent(args: ResolveAgentArgs): ResolveAgentResult;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { KeychainManager, keychainManager, KeychainError } from './keychain';
 export { CryptoService, cryptoService, CryptoError, ENCRYPTION_VERSION } from './crypto';
-export { AppSyncClient, DownloadUrlResponse } from './appsync';
+export { AppSyncClient, AppSyncGraphQLError, DownloadUrlResponse } from './appsync';
 export { queries, mutations, subscriptions } from './appsync';
 export { AuthService, authService } from './auth';
 export { runAuthCli } from './auth';
@@ -13,8 +13,16 @@ export { parseInteractivePrompt, normalizeSnapshot, } from './prompt-parser';
 export type { ParsedInteractivePrompt, PromptKind, InteractivePromptOption, } from './prompt-parser';
 export { resumeOrCreateSession, prepareSessionEncryption, rekeySessionForNewDevices, startDeviceKeyWatcher, registerDeviceEncryptionKey, } from './session';
 export type { ResumeOrCreateSessionInput, ResumeOrCreateSessionResult } from './session';
-export { detectInstalledAgents, pushDetectedAgents, applyPerSessionOrchestrationOverride, runOrchestrationCli, } from './orchestration';
-export type { DetectableAgent } from './orchestration';
+export { detectInstalledAgents, pushDetectedAgents, applyPerSessionOrchestrationOverride, runOrchestrationCli, V1_ORCHESTRATION_PROMPT_KIND, V1_ORCHESTRATION_OPTIONS, mapOptionNumberToUserDecisionKind, mapOptionToUserDecisionKind, } from './orchestration';
+export type { DetectableAgent, V1OrchestrationOption, V1UserDecisionKind, } from './orchestration';
 export * as Reviewer from './reviewer';
 export * as AuditKeys from './audit-keys';
 export * from './types';
+export * as Planner from './planner';
+export * as StructuralSummary from './structural-summary';
+export { runOrchestrationShell } from './orchestration-shell';
+export { runCompanionMode } from './companion-mode';
+export { pickMode, TierError } from './orchestration-shell';
+export { emitShellEvent, createShellEventEmitter } from './orchestration-shell';
+export { processMarkers, withRoleMarker } from './orchestration-shell';
+export type { Mode, Tier, PlannerDecision, AgentKind, PlannerHealthState, OrchestrationState, OrchestrationAction, ConversationEntry, RunningTaskState, ReviewerSeatState, GateState, ExecutionEventEntry, RefusalEventEntry, BypassEventEntry, MobileEventEntry, EventStreamEntry, QueuedTask, PendingClarification, LastModeFile, } from './orchestration-shell';