qlogicagent 2.24.1 → 2.24.2

package/dist/types/runtime/infra/acp-protocol-adapter.d.ts

@@ -1,209 +0,0 @@
-/**
- * ACP Protocol Adapter — a thin wrapper over the official @agentclientprotocol/sdk
- * `ClientSideConnection`. qlogicagent is the ACP *client* (host); spawned external
- * agents (codex-acp, claude-agent-acp, xiaozhiclaw, …) are the ACP *agents*.
- *
- * The SDK owns the wire protocol entirely: JSON-RPC 2.0 / NDJSON framing, request↔response
- * correlation, and the reverse-RPC dispatch. This module owns only the three concerns the SDK
- * leaves to the host:
- *   1. bridging a Node ChildProcess's stdio to the SDK's web-stream transport (ndJsonStream)
- *   2. mapping our loose `AcpHostRequestHandler` onto the typed SDK `Client` interface
- *   3. translating SDK `session/update` notifications into qlogicagent's internal `turn.*` methods
- *
- * Extension capabilities (clientCapabilities.qlogicagent) are forwarded verbatim — the SDK does
- * not strip outgoing params (validation runs only on the receiving side), so xiaozhiclaw interop is
- * preserved.
- */
-import type { ChildProcess } from "node:child_process";
-import type { AcpInitializeResult, AcpSessionResult, AcpPromptResponse, McpServerConfig } from "../../protocol/wire/acp-agent-management.js";
-interface AcpPromptTimeoutOptions {
-    timeoutMs?: number;
-    getLastActivityAt?: () => number | undefined;
-    checkIntervalMs?: number;
-}
-type AcpPromptTimeoutInput = number | AcpPromptTimeoutOptions;
-/**
- * Handler for agent→host requests (fs, terminal, permission, elicitation).
- * Host implementations should implement the methods they support. This is intentionally loose
- * (Record-typed) — {@link AcpProtocolAdapter} bridges it onto the SDK's strongly-typed Client.
- */
-export interface AcpHostRequestHandler {
-    /** Read a text file from the host filesystem. */
-    readTextFile?(params: {
-        path: string;
-    }): Promise<{
-        content: string;
-    } | undefined>;
-    /** Write a text file on the host filesystem. */
-    writeTextFile?(params: {
-        path: string;
-        content: string;
-    }): Promise<Record<string, unknown> | undefined>;
-    /** Request permission for a tool call. Returns the chosen option id (host responsibility). */
-    requestPermission?(params: Record<string, unknown>): Promise<{
-        optionId: string;
-    }>;
-    /** Elicitation request (ask user for input). */
-    elicitation?(params: Record<string, unknown>): Promise<Record<string, unknown>>;
-    /** Create a terminal session. */
-    createTerminal?(params: Record<string, unknown>): Promise<Record<string, unknown> | undefined>;
-    /** Terminal output data. */
-    terminalOutput?(params: Record<string, unknown>): Promise<Record<string, unknown> | undefined>;
-    /** Release a terminal. */
-    releaseTerminal?(params: Record<string, unknown>): Promise<Record<string, unknown>>;
-    /** Wait for terminal exit. */
-    waitForTerminalExit?(params: Record<string, unknown>): Promise<Record<string, unknown> | undefined>;
-    /** Kill a terminal. */
-    killTerminal?(params: Record<string, unknown>): Promise<Record<string, unknown>>;
-    /** Extension method (unknown method from agent). */
-    extMethod?(method: string, params: unknown): Promise<unknown>;
-}
-/** Internal representation of an ACP notification translated to qlogicagent format. */
-export interface TranslatedNotification {
-    method: string;
-    params: Record<string, unknown>;
-}
-/** An auth method an agent advertises when it needs the user to log in (subset of ACP shape). */
-export interface AcpAuthMethod {
-    id?: string;
-    name?: string;
-    description?: string;
-    /**
-     * ACP auth-method discriminator (when the agent follows the discriminated schema):
-     *  - "agent"    : the agent self-drives login (opens its own browser / prints a device code)
-     *  - "env_var"  : the user supplies a key — surface a key dialog (≈ userKey)
-     *  - "terminal" : run an interactive login command (the agent's own `login` subcommand)
-     * Drives how the host routes the login affordance (see classifyAuthMethod). Absent on agents that
-     * don't tag their methods — those fall back to guide-only.
-     */
-    type?: "agent" | "env_var" | "terminal" | string;
-    /** For a terminal-type method: the command + args the host runs to start the interactive login. */
-    args?: string[];
-    /** For a terminal-type method: extra env for the login command. */
-    env?: Record<string, string>;
-}
-/** How the host should surface a login for an advertised auth method (spec §7). */
-export type AuthMethodRouting = "agent" | "key" | "terminal" | "guide";
-/**
- * Route an advertised auth method to the right login affordance:
- *  agent → drive the ACP `authenticate` request; env_var → open a key dialog (userKey); terminal →
- *  run the agent's interactive login command; otherwise guide-only (show the command, user runs it).
- * Gating login on a concrete classified method (never a heuristic) prevents firing an uncompletable
- * login (e.g. claude's key-only method) — spec §7 risk.
- */
-export declare function classifyAuthMethod(method: AcpAuthMethod | undefined): AuthMethodRouting;
-/**
- * Thrown when an agent rejects session setup because the user must authenticate first — e.g. kimi
- * returns -32000 "Authentication required" with a `kimi login` authMethod. Carries the agent's
- * advertised authMethods and `retryable = false`, so the spawn layer surfaces it immediately (a
- * missing login never heals by retrying) with an actionable message instead of a generic failure.
- */
-export declare class AcpAuthRequiredError extends Error {
-    readonly retryable: false;
-    readonly authMethods: AcpAuthMethod[];
-    constructor(message: string, authMethods: AcpAuthMethod[]);
-}
-/**
- * Recognise the ACP "authentication required" failure (by code -32000, an authMethods payload, or
- * message text) and convert it to an {@link AcpAuthRequiredError} whose message tells the user how
- * to log in (from the agent's own authMethod description). Returns null for any other error.
- */
-export declare function asAuthRequiredError(err: unknown, fallbackAuthMethods?: AcpAuthMethod[]): AcpAuthRequiredError | null;
-export declare class AcpProtocolAdapter {
-    private conn;
-    private child;
-    private onNotification;
-    private hostHandler;
-    /** Sessions whose session/set_model FAILED — running on the agent's default model, not the managed one. */
-    private modelMismatches;
-    /**
-     * Attach to a child process's stdio for ACP communication.
-     * Constructs the official ClientSideConnection over the child's stdin/stdout. The connection's
-     * read loop starts immediately, so incoming notifications + reverse-RPC are live after this call.
-     *
-     * @param child The spawned ACP agent process
-     * @param onNotification Callback for agent notifications (raw method + params; caller translates)
-     * @param hostHandler Optional handler for agent→host requests (fs, terminal, permission)
-     */
-    attach(child: ChildProcess, onNotification?: (method: string, params: unknown) => void, hostHandler?: AcpHostRequestHandler): void;
-    /**
-     * qlogicagent extends ACP `session/update` with an `x_*` variant namespace (x_relay, x_session_info, …) that the standard SDK schema does not model and therefore rejects. Detect
-     * those notifications on the read side and dispatch them to onNotification directly — bypassing the
-     * SDK's strict validation — so the host's usage/progress accumulation runs exactly as it does for the
-     * internal-agent path. Returns true when the message was consumed here (and must be hidden from the
-     * SDK); false for everything else (standard updates, requests, responses) which the SDK handles.
-     */
-    private consumeExtensionNotification;
-    /**
-     * Build the SDK Client implementation (agent→host reverse-RPC) from our loose host handler.
-     * Re-reads this.hostHandler / this.onNotification on each call so detach() takes effect.
-     */
-    private buildClient;
-    /** Detach from the child process. The SDK read loop ends when the child's stdout closes. */
-    detach(): void;
-    private requireConn;
-    /** Race a connection call against a timeout; optionally run a side effect (e.g. cancel) on timeout. */
-    private withTimeout;
-    private withActivityTimeout;
-    /**
-     * Perform the ACP initialize handshake. Sends standard clientInfo + clientCapabilities plus the
-     * qlogicagent extension capability (forwarded verbatim by the SDK).
-     */
-    initialize(_child?: ChildProcess): Promise<AcpInitializeResult>;
-    /**
-     * Create an ACP session (session/new). A non-standard systemPrompt is forwarded under `_meta`
-     * (the ACP extension mechanism) so it survives validation on the agent side.
-     */
-    createSession(_child: ChildProcess, options: {
-        cwd: string;
-        mcpServers?: McpServerConfig[];
-        additionalDirectories?: string[];
-        systemPrompt?: string;
-        /** Platform/managed model to select over ACP after session/new (see selectSessionModel). */
-        model?: string;
-    }): Promise<AcpSessionResult>;
-    /**
-     * Select the platform/managed model over ACP after session/new. External CLIs (notably
-     * claude-code-acp) default to their OWN model (e.g. Sonnet 4.5) and merely EXPOSE the injected
-     * ANTHROPIC_MODEL/OPENAI_MODEL as an "available" option — they do NOT select it. Left on the default,
-     * the first prompt fails ("issue with the selected model …") because the platform shelf has no such
-     * model, and it surfaces as a cryptic "Agent process stdio closed". Best-effort: when the agent
-     * advertised its models, only switch if it offers `desired` and isn't already on it; otherwise attempt
-     * anyway and swallow rejection (the session still exists on its default model — the wrong-model prompt
-     * error is the backstop). Uses the generic sendRequest because the SDK has no typed set_model yet.
-     */
-    private selectSessionModel;
-    /**
-     * The recorded session/set_model failure for a session, if any — the session is alive but on
-     * the agent's DEFAULT model instead of the managed/platform one (wrong vendor/billing/capability).
-     */
-    getModelMismatch(sessionId: string): {
-        desired: string;
-        error: string;
-    } | undefined;
-    /**
-     * Send a prompt to a running ACP session (session/prompt). Content streams back via session/update
-     * notifications during execution; the response carries only { stopReason, usage? }. On timeout the
-     * turn is cancelled (session/cancel) so the agent stops cleanly.
-     */
-    sendPrompt(_child: ChildProcess, sessionId: string, content: string, timeoutInput?: AcpPromptTimeoutInput): Promise<AcpPromptResponse>;
-    /**
-     * Resume an existing ACP session (session/load — replays history via notifications).
-     * Only valid when the agent advertised the loadSession capability.
-     */
-    resumeSession(_child: ChildProcess, sessionId: string, options?: {
-        cwd?: string;
-        mcpServers?: McpServerConfig[];
-        model?: string;
-    }): Promise<AcpSessionResult>;
-    /**
-     * Translate an ACP notification into qlogicagent's internal format.
-     * Returns null if the notification is not translatable (handled separately).
-     *
-     * Standard ACP: agent sends "session/update" with params { sessionId, update: { sessionUpdate, … } }.
-     * Used by both the external-agent path (this adapter) and the internal/builtin agent path, so it
-     * stays a pure static function decoupled from the connection.
-     */
-    static translateNotification(method: string, params: unknown): TranslatedNotification | null;
-}
-export {};

package/dist/types/runtime/infra/acp-usage-tracker.d.ts

@@ -1,46 +0,0 @@
-/**
- * ACP Usage Tracker — 3-tier token usage tracking for external ACP agents.
- *
- * Tier 1: Real-time `usage_update` notifications (preferred).
- * Tier 2: Per-turn `PromptResponse.usage` fallback.
- * Tier 3: Graceful degradation — no usage data, no budget enforcement.
- *
- * The tracker prevents double-counting when an agent sends both
- * usage_update notifications AND prompt response usage.
- */
-import type { AcpUsageUpdatePayload, AcpPromptResponseUsage } from "../../protocol/wire/acp-agent-management.js";
-export interface AccumulatedUsage {
-    inputTokens: number;
-    outputTokens: number;
-    totalTokens: number;
-    cachedReadTokens: number;
-    thoughtTokens: number;
-    /** Total cost (USD), if reported. */
-    cost: number;
-    /** Whether at least one usage_update was received (Tier 1 active). */
-    hasTier1: boolean;
-    /** Number of turns processed (Tier 2 fallback). */
-    turnCount: number;
-}
-export declare class AcpUsageTracker {
-    private usage;
-    /**
-     * Tier 1: Handle a `usage_update` notification from ACP agent.
-     * Sets the hasTier1 flag to prevent double-counting from Tier 2.
-     */
-    onUsageUpdate(payload: AcpUsageUpdatePayload): void;
-    /**
-     * Tier 2: Handle per-turn usage from PromptResponse.
-     * Only applied if Tier 1 is NOT active (prevents double-counting).
-     */
-    onPromptResponseUsage(usage: AcpPromptResponseUsage | undefined): void;
-    /** Get the current accumulated usage snapshot. */
-    getUsage(): Readonly<AccumulatedUsage>;
-    /** Reset all counters. */
-    reset(): void;
-    /**
-     * Check whether we have any usage data.
-     * Returns false in Tier 3 (graceful degradation).
-     */
-    hasData(): boolean;
-}

package/dist/types/runtime/infra/cloud-auth-host-authority.d.ts

@@ -1,4 +0,0 @@
-import type { HostCloudAuthClient } from "../../transport/host-cloud-auth-client.js";
-/** Process-lifetime binding installed after ACP Host capability negotiation. */
-export declare function configureHostCloudAuthAuthority(resolver: () => HostCloudAuthClient | undefined): void;
-export declare function getHostCloudAuthAuthority(): HostCloudAuthClient | undefined;

package/dist/types/runtime/infra/feedback-distillation-worker.d.ts

@@ -1,20 +0,0 @@
-/**
- * Feedback distillation worker (design §11; mini-design 2026-06-28 v2) — the idle-triggered sweep
- * that turns a project's accumulated feedback into memory proposals. Scheduling mirrors the upload
- * worker + dream: a pure work unit, callers serialize per project (§9.1 rule 9). It is append-only
- * into the SHARED memory pipeline (proposeExtracted, source="feedback") — it never promotes; dream /
- * consolidator own merge + promote (§11.2). The store-level idempotency key (§10) makes the sweep
- * safe to re-run: a retried sweep, or a worker restart mid-sweep, never duplicates a proposal.
- */
-import type { MemoryDreamProvider } from "../ports/memory-provider.js";
-export interface FeedbackDistillationResult {
-    candidates: number;
-    proposed: number;
-}
-/**
- * One distillation sweep for a project: cluster active feedback into candidates, append each as a
- * memory proposal. Fail-soft per candidate — one rejected proposal never aborts the rest of the
- * sweep. Returns counts for logging. The memory provider must expose proposeExtracted (the dream
- * provider does); if it doesn't, the sweep is a no-op.
- */
-export declare function runFeedbackDistillationSweep(projectId: string, sink: Pick<MemoryDreamProvider, "proposeExtracted">, userId: string): Promise<FeedbackDistillationResult>;

package/dist/types/runtime/infra/feedback-distillation.d.ts

@@ -1,32 +0,0 @@
-import type { FeedbackEvent } from "./feedback-event-store.js";
-type DistillableFeedback = Pick<FeedbackEvent, "feedbackId" | "rating" | "reason" | "state" | "sessionId" | "turnId">;
-/** Minimum corroborating active events before a cluster becomes a proposal (mini-design §3.4). */
-export declare const MIN_EVIDENCE = 2;
-export interface FeedbackDistillationCandidate {
-    clusterKey: string;
-    /** Template preference sentence (dream LLM refines later — mini-design §9.3). */
-    text: string;
-    category: string;
-    importance: number;
-    confidence: number;
-    /** Audit trail + crash-safe idempotency, consumed by the extended proposeExtracted (§10). */
-    evidence: {
-        kind: "feedback";
-        refs: string[];
-        idempotencyKey: string;
-    };
-    /** Cluster diagnostics — not persisted as-is; surfaced for tests + logging. */
-    stats: {
-        evidence: number;
-        crossSession: boolean;
-        feedbackIds: string[];
-        turnIds: string[];
-    };
-}
-/**
- * Cluster a project's feedback events into proposal candidates. Only active events count
- * (retracted / replaced are filtered — §11.1). Clusters below MIN_EVIDENCE are dropped. Output is
- * sorted by clusterKey for deterministic ordering across runs.
- */
-export declare function distillFeedback(events: DistillableFeedback[]): FeedbackDistillationCandidate[];
-export {};

package/dist/types/runtime/infra/feedback-event-store.d.ts

@@ -1,179 +0,0 @@
-export type FeedbackRating = "up" | "down";
-export type FeedbackState = "active" | "retracted" | "replaced";
-export type TelemetryStatus = "complete" | "partial" | "missing";
-export type FeedbackReason = "missed_requirement" | "incomplete" | "broken_file_link_or_panel" | "code_or_test_failed" | "factually_wrong" | "too_verbose" | "too_short" | "wrong_style" | "other";
-export interface FeedbackUsage {
-    inputTokens?: number;
-    outputTokens?: number;
-    totalTokens?: number;
-}
-export interface FeedbackToolSummary {
-    calledTools: string[];
-    failedTools: string[];
-    blockedTools: string[];
-}
-export interface FeedbackFileContext {
-    changedFileCount?: number;
-    changedPathsPreview?: string[];
-    hasTurnFileChanges?: boolean;
-    diffOpenState?: "not_applicable" | "opened" | "failed" | "unknown";
-}
-export interface FeedbackBrowserContext {
-    url?: string;
-    hadToastError?: boolean;
-    visiblePanel?: "chat" | "artifact" | "diff" | "unknown";
-}
-export interface FeedbackEvent {
-    feedbackId: string;
-    rating: FeedbackRating;
-    reason?: FeedbackReason;
-    comment?: string;
-    state: FeedbackState;
-    projectId?: string;
-    sessionId: string;
-    turnId: string;
-    assistantMessageId: string;
-    userId?: string;
-    telemetryStatus: TelemetryStatus;
-    messageRole: "assistant";
-    messagePreview: string;
-    messageHash: string;
-    model?: string;
-    provider?: string;
-    agentMode?: "chat" | "solo" | "product" | "workflow" | "unknown";
-    sourceChannel?: string;
-    usage?: FeedbackUsage;
-    toolSummary?: FeedbackToolSummary;
-    fileContext?: FeedbackFileContext;
-    browserContext?: FeedbackBrowserContext;
-    upload?: {
-        eligible: boolean;
-        uploadedAt?: string;
-        uploadBatchId?: string;
-        redactionVersion?: string;
-    };
-    /**
-     * Local distillation bookkeeping (mini-design §6): records that this event was folded into a
-     * memory proposal, and under which cluster + idempotency key. Observability only — the crash-safe
-     * dedup guard is the store-level idempotency key on the proposal, not this field.
-     */
-    distill?: {
-        proposedAt: string;
-        clusterKey: string;
-        idempotencyKey: string;
-    };
-    createdAt: string;
-    updatedAt: string;
-}
-/** Telemetry-joined + click-time context the handler assembles before persisting. */
-export interface FeedbackContext {
-    telemetryStatus: TelemetryStatus;
-    messagePreview: string;
-    messageHash: string;
-    userId?: string;
-    model?: string;
-    provider?: string;
-    agentMode?: FeedbackEvent["agentMode"];
-    sourceChannel?: string;
-    usage?: FeedbackUsage;
-    toolSummary?: FeedbackToolSummary;
-    fileContext?: FeedbackFileContext;
-    browserContext?: FeedbackBrowserContext;
-}
-export interface FeedbackSubmitInput {
-    rating: FeedbackRating;
-    reason?: FeedbackReason;
-    comment?: string;
-    projectId: string;
-    sessionId: string;
-    turnId: string;
-    assistantMessageId: string;
-    context: FeedbackContext;
-}
-export interface FeedbackStateEntry {
-    turnId: string;
-    assistantMessageId: string;
-    feedbackId: string;
-    rating: FeedbackRating;
-    reason?: FeedbackReason;
-    state: FeedbackState;
-    updatedAt: string;
-}
-export interface FeedbackSummary {
-    total: number;
-    active: number;
-    retracted: number;
-    replaced: number;
-    upCount: number;
-    downCount: number;
-    byReason: Record<string, number>;
-    byModel: Record<string, number>;
-    byAgentMode: Record<string, number>;
-    telemetryStatusCounts: Record<TelemetryStatus, number>;
-}
-export declare function hashMessageContent(content: string): string;
-/**
- * Create / switch / re-activate the feedback for a turn. Returns the stable feedbackId and the
- * resulting state. Submitting the SAME rating while already active is a no-op (idempotent retry).
- */
-export declare function submitFeedback(input: FeedbackSubmitInput): Promise<{
-    feedbackId: string;
-    state: FeedbackState;
-}>;
-/**
- * Retract the active feedback for a turn (the frontend calls this when the user re-clicks the
- * already-selected button). Idempotent: retracting when there is nothing active is a no-op.
- */
-export declare function retractFeedback(input: {
-    projectId: string;
-    turnId: string;
-    feedbackId?: string;
-}): Promise<{
-    ok: boolean;
-    feedbackId?: string;
-    state: FeedbackState | null;
-}>;
-/**
- * Hydrate feedback state for a session's messages (initial render / refresh). Returns only ACTIVE
- * feedback (absent = not rated) — the fixed contract per design §8.3, so the UI never has to
- * interpret retracted/replaced records.
- */
-export declare function getFeedbackState(input: {
-    projectId: string;
-    sessionId: string;
-    turnIds?: string[];
-    assistantMessageIds?: string[];
-}): Promise<{
-    states: FeedbackStateEntry[];
-}>;
-/** Local single-instance aggregate used by messageFeedback.summary. Raw message text is not returned. */
-export declare function summarizeFeedback(input: {
-    projectId: string;
-    sessionId?: string;
-    since?: string;
-    until?: string;
-}): Promise<FeedbackSummary>;
-/**
- * Events eligible for cloud upload that have not yet been assigned to a batch (design §10). The
- * worker redacts + ships these; once assigned a batchId (delivered or queued for retry) they are
- * skipped until a state change resets the upload marks.
- */
-export declare function listUploadableFeedback(projectId: string): Promise<FeedbackEvent[]>;
-/** Mark an event as assigned to an in-flight upload batch (queued for retry, not yet delivered). */
-export declare function assignFeedbackBatch(projectId: string, turnId: string, uploadBatchId: string): Promise<void>;
-/** Mark an event as successfully uploaded (stamps uploadedAt + batch + redactionVersion). */
-export declare function markFeedbackUploaded(projectId: string, turnId: string, uploadBatchId: string, redactionVersion: string): Promise<void>;
-/**
- * Active feedback eligible for memory distillation (mini-design §3.1). Distillation re-clusters the
- * full active set every sweep; the store-level idempotency key (not a per-event flag) prevents
- * duplicate proposals, so this intentionally returns ALL active events — already distilled or not.
- * A newly added active event simply changes a cluster's id set and yields a fresh proposal.
- */
-export declare function listDistillableFeedback(projectId: string): Promise<FeedbackEvent[]>;
-/** Stamp local distillation bookkeeping on an event (which cluster + idempotency key folded it in). */
-export declare function markFeedbackDistilled(projectId: string, turnId: string, info: {
-    clusterKey: string;
-    idempotencyKey: string;
-}): Promise<void>;
-/** Test helper: read the raw stored event for a turn (including retracted), or null. */
-export declare function __getFeedbackEventForTest(projectId: string, turnId: string): Promise<FeedbackEvent | null>;

package/dist/types/runtime/infra/feedback-host-authority.d.ts

@@ -1,4 +0,0 @@
-import type { HostFeedbackClient } from "../../transport/host-feedback-client.js";
-/** Process-lifetime binding installed by stdio-server after ACP initialize capability negotiation. */
-export declare function configureHostFeedbackAuthority(resolver: () => HostFeedbackClient | undefined): void;
-export declare function getHostFeedbackAuthority(): HostFeedbackClient | undefined;

package/dist/types/runtime/infra/feedback-outbox.d.ts

@@ -1,26 +0,0 @@
-export type OutboxOp = "uploadBatch";
-export interface OutboxEntry {
-    entryId: string;
-    /** Dedup key — re-enqueuing the same logical op is a no-op (no double upload). */
-    idempotencyKey: string;
-    op: OutboxOp;
-    payload: unknown;
-    attempts: number;
-    createdAt: string;
-    nextAttemptAt: string;
-    lastError?: string;
-}
-/** Enqueue a failed op for retry. Idempotent: an existing entry with the same key is kept as-is. */
-export declare function enqueueOutbox(projectId: string, input: {
-    idempotencyKey: string;
-    op: OutboxOp;
-    payload: unknown;
-}, now?: Date): Promise<OutboxEntry>;
-/** Entries whose backoff window has elapsed and that have not exhausted their retry budget. */
-export declare function listDueOutbox(projectId: string, now?: Date): Promise<OutboxEntry[]>;
-/** Drop a successfully-delivered entry. */
-export declare function removeOutbox(projectId: string, entryId: string): Promise<void>;
-/** Record a failed attempt: bump attempts + schedule the next retry with exponential backoff. */
-export declare function markOutboxFailure(projectId: string, entryId: string, error: string, now?: Date): Promise<void>;
-/** Entries that have exhausted their retry budget — kept for local audit, never re-sent. */
-export declare function listExhaustedOutbox(projectId: string): Promise<OutboxEntry[]>;

package/dist/types/runtime/infra/feedback-redaction.d.ts

@@ -1,71 +0,0 @@
-import type { FeedbackEvent, FeedbackRating, FeedbackReason, FeedbackState, FeedbackToolSummary, FeedbackUsage, TelemetryStatus } from "./feedback-event-store.js";
-/** Bump when the redaction rules change so uploaded samples stay traceable (§8.6/§13). */
-export declare const REDACTION_VERSION = "feedback-redaction-v1";
-export interface RedactedFeedbackEvent {
-    feedbackId: string;
-    rating: FeedbackRating;
-    reason?: FeedbackReason;
-    state: FeedbackState;
-    /** Hashed identity — correlate without exposing local ids (§8.6). */
-    messageHash: string;
-    sessionIdHash: string;
-    projectIdHash?: string;
-    turnIdHash: string;
-    /** ≤500 chars, secrets/emails/absolute-paths scrubbed (§13). */
-    messagePreview: string;
-    model?: string;
-    provider?: string;
-    agentMode?: FeedbackEvent["agentMode"];
-    sourceChannel?: string;
-    usage?: FeedbackUsage;
-    /** Tool names only (never args). */
-    toolSummary?: FeedbackToolSummary;
-    fileContext?: {
-        changedFileCount?: number;
-        hasTurnFileChanges?: boolean;
-        diffOpenState?: "not_applicable" | "opened" | "failed" | "unknown";
-    };
-    browserContext?: {
-        hadToastError?: boolean;
-        visiblePanel?: "chat" | "artifact" | "diff" | "unknown";
-    };
-    telemetryStatus: TelemetryStatus;
-    redactionVersion: string;
-    createdAt: string;
-}
-export interface FeedbackRollup {
-    rollupId: string;
-    periodStart: string;
-    periodEnd: string;
-    total: number;
-    upCount: number;
-    downCount: number;
-    /** Down-vote reason → count. */
-    byReason: Record<string, number>;
-    byModel: Record<string, {
-        up: number;
-        down: number;
-    }>;
-    byAgentMode: Record<string, {
-        up: number;
-        down: number;
-    }>;
-    telemetryStatusCounts: {
-        complete: number;
-        partial: number;
-        missing: number;
-    };
-    redactionVersion: string;
-    createdAt: string;
-}
-/** Truncate to the preview limit and scrub api keys / emails / absolute paths (§13). */
-export declare function sanitizePreview(text: string): string;
-/** Map a local feedback event to its upload-safe redacted form (§8.6/§13). */
-export declare function redactFeedbackEvent(event: FeedbackEvent, redactionVersion?: string): RedactedFeedbackEvent;
-/** Pre-aggregate a batch of local events into a rollup for low-cost trend upload (§10). */
-export declare function aggregateFeedbackRollup(events: FeedbackEvent[], input: {
-    rollupId: string;
-    periodStart: string;
-    periodEnd: string;
-    redactionVersion?: string;
-}): FeedbackRollup;

package/dist/types/runtime/infra/feedback-upload-client.d.ts

@@ -1,39 +0,0 @@
-/**
- * Feedback upload client — the single HTTP exit that ships redacted feedback to the llmrouter
- * feedback backend (design §8.6, §9.1 rule 4). The redaction worker calls this directly; the
- * messageFeedback.uploadBatch RPC wraps it for manual/test triggers.
- *
- * Transport mirrors the usage client: append the route to the llmrouter base already injected into
- * the agent (QLOGIC_LLMROUTER_BASE_URL, e.g. https://www.qlogicagent.com/api) and authenticate with
- * the injected Bearer QLOGIC_LLMROUTER_ACCESS_TOKEN. Feedback lands at <base>/client/feedback, so a
- * batch POSTs to <base>/client/feedback/uploadBatch — the contract the llmrouter ingest endpoint
- * (Phase 3b) implements. No dedicated feedback env: one llmrouter base, like /client/usage.
- */
-import type { FeedbackRollup, RedactedFeedbackEvent } from "./feedback-redaction.js";
-export interface UploadBatchInput {
-    batchId: string;
-    events: RedactedFeedbackEvent[];
-    rollups: FeedbackRollup[];
-    redactionVersion: string;
-    clientBuild?: string;
-    runtimeVersion?: string;
-    qlogicagentVersion?: string;
-}
-export interface UploadBatchResult {
-    ok: boolean;
-    accepted?: number;
-    status?: number;
-    error?: string;
-}
-/**
- * Resolve the feedback ingest base, derived from the llmrouter base already injected into the agent
- * (QLOGIC_LLMROUTER_BASE_URL), mirroring how the usage client reaches /client/usage. Returns
- * undefined when llmrouter is not configured.
- */
-export declare function resolveFeedbackUploadBaseUrl(): string | undefined;
-/**
- * Ship one redacted batch to llmrouter. Fail-soft: an unconfigured base or a transport/HTTP error
- * returns { ok: false }, so the caller (worker) keeps the events eligible and queues a retry rather
- * than dropping feedback. Idempotent at the server by batchId + event id (§9.1 rule 5).
- */
-export declare function uploadFeedbackBatch(input: UploadBatchInput, signal?: AbortSignal): Promise<UploadBatchResult>;

package/dist/types/runtime/infra/feedback-upload-worker.d.ts

@@ -1,11 +0,0 @@
-export interface FeedbackSweepResult {
-    uploaded: number;
-    queued: number;
-    retried: number;
-}
-/**
- * One feedback upload sweep for a project. Retries due outbox batches, then redacts + ships any
- * newly uploadable events. Fail-soft: a failed upload is queued in the outbox (its events assigned
- * the batchId so they are not re-picked) and retried on a later sweep with backoff.
- */
-export declare function runFeedbackUploadSweep(projectId: string, now?: Date): Promise<FeedbackSweepResult>;