@wrongstack/core 0.299.0 → 0.301.0

package/dist/coordination/mail-tools.d.ts

@@ -75,12 +75,12 @@ export declare function makeMailSendTool(opts?: MailToolsOptions): {
         required: string[];
     };
     execute(input: unknown, ctx: Context): Promise<{
-        ok: boolean;
-        error: string;
         messageId?: never;
-        from?: never;
         to?: never;
         summary?: never;
+        ok: boolean;
+        error: string;
+        from?: never;
     } | {
         error?: never;
         ok: boolean;

package/dist/coordination/mailbox-project-server.js

@@ -1371,9 +1371,7 @@ function isMailboxMessageVisibleTo(message, agentId, role) {
 }
 function validateSendType(type, to) {
   if (type === "control") {
-    throw new TypeError(
-      'Type "control" is reserved for runtime use and cannot be set by agents'
-    );
+    throw new TypeError('Type "control" is reserved for runtime use and cannot be set by agents');
   }
   const isMultiRecipient = to === "*" || to.startsWith("@session:");
   if (type === "assign" && isMultiRecipient) {
@@ -1411,7 +1409,8 @@ function isMailboxReceiptRecordV2(value) {
   if (typeof v["timestamp"] !== "string" || v["timestamp"].length === 0) return false;
   if ("read" in v && typeof v["read"] !== "boolean") return false;
   if ("completed" in v && typeof v["completed"] !== "boolean") return false;
-  if ("outcome" in v && v["outcome"] !== void 0 && typeof v["outcome"] !== "string") return false;
+  if ("outcome" in v && v["outcome"] !== void 0 && typeof v["outcome"] !== "string")
+    return false;
   return true;
 }
 

package/dist/coordination/mailbox-types.d.ts

@@ -204,6 +204,12 @@ export interface MailboxSessionAffinityContext {
  *    compatibility).
  * 6. Otherwise drop (`false`).
  *
+ * PR #314 guard contract: presence checks intentionally use strict
+ * `!== undefined` comparisons for both the affinity token and its optional
+ * fields. Do not simplify them to nullish checks: malformed persisted `null`
+ * values must remain on the token-bearing path and fail closed in the shape
+ * guard rather than being treated as absent.
+ *
  * Trust note: the filter accepts the sender-asserted `sessionAffinity.sessionId`
  * without store cross-check (rule 3). The persisted-report fallback (rule 4)
  * is the only server-side check. A sender that fabricates both an affinity

package/dist/coordination/multi-agent-coordinator.d.ts

@@ -186,6 +186,7 @@ export declare class DefaultMultiAgentCoordinator extends EventEmitter implement
      * `awaitTasks()` caller. Pushes the result and fires the event directly.
      */
     private emitPendingAborted;
+    private trimCompletedResults;
     private runDispatched;
     private executeWithTimeout;
     private recordCompletion;

package/dist/core/agent-response.d.ts

@@ -28,7 +28,11 @@ export interface AgentResponseHandler {
  * todos change during tool execution. Keeping this block volatile makes the
  * final-response contract follow the live todo state on every iteration.
  */
-export declare function buildLiveNextStepsGateBlock(ctx: Pick<Context, 'agentId' | 'todos'>): TextBlock | undefined;
+export declare function buildLiveNextStepsGateBlock(ctx: Pick<Context, 'agentId' | 'todos'> & {
+    tools?: readonly {
+        name: string;
+    }[] | undefined;
+}): TextBlock | undefined;
 export declare function createAgentResponseHandler(a: AgentInternals): AgentResponseHandler;
 export {};
 //# sourceMappingURL=agent-response.d.ts.map

package/dist/core/agent-tools.d.ts

@@ -12,6 +12,9 @@ export interface AgentToolHandler {
         id: string;
         name: string;
         input: unknown;
+    }, preToolContext?: {
+        text: string;
+        contextAs: 'inline' | 'separate';
     }): Promise<{
         result: ToolResultBlock;
         durationMs: number;

package/dist/core/context.d.ts

@@ -50,6 +50,8 @@ export interface ContextInit {
     allowOutsideProjectRoot?: boolean | undefined;
     model: string;
     tools?: Tool[] | undefined;
+    /** Complete executable catalog for lazy discovery/meta-tools. */
+    catalogTools?: Tool[] | undefined;
     /** Agent id performing this run (e.g. 'leader', 'executor', 'tech-stack'). */
     agentId?: string | undefined;
     /** Human-readable agent name. */
@@ -63,6 +65,12 @@ export interface ContextInit {
      */
     traceId?: string | undefined;
 }
+export interface ProviderMemoryEvidence {
+    /** Stable owner key, for example `sage.tool-memory`. */
+    source: string;
+    /** Provider-bound evidence text; never appended to chat/tool history. */
+    text: string;
+}
 /**
  * L1-A: `Context` is the live agent-run object. Its read-only environment
  * shape is exposed by the `RunEnv` interface (every field below the
@@ -197,6 +205,8 @@ export declare class Context implements RunEnv {
     allowOutsideProjectRoot: boolean;
     model: string;
     tools: Tool[];
+    /** Complete enabled catalog; provider token accounting continues to use `tools`. */
+    catalogTools: Tool[];
     meta: Record<string, unknown>;
     /** Agent id performing this run (e.g. 'leader', 'executor'). */
     agentId: string;
@@ -266,6 +276,16 @@ export declare class Context implements RunEnv {
      * Cleared after being consumed by agent-tools.
      */
     pendingPostToolContext: string | undefined;
+    /**
+     * Bounded, provider-bound memory evidence kept outside conversation and
+     * tool-result history. Owners replace their own slot instead of appending a
+     * fresh message on every retrieval, so long sessions do not accumulate the
+     * same SAGE hints. Request construction emits these as ephemeral system
+     * suffixes, preserving the stable prompt-cache prefix.
+     */
+    memoryEvidence: ProviderMemoryEvidence[];
+    setMemoryEvidence(source: string, text: string | undefined, maxChars?: number): void;
+    clearMemoryEvidence(source?: string): void;
     /**
      * H1: pre-computed total-request token estimate from the most recent
      * `estimateRequestTokens()` call in the agent loop's pre-flight step.

package/dist/core/fallback-model.d.ts

@@ -90,7 +90,55 @@ export interface FallbackModelDeps {
      * the fallback chain.
      */
     statusTracker?: ProviderModelStatusTracker | undefined;
+    /**
+     * When set, the fallback chain pauses BEFORE attempting any fallback entry
+     * and emits `provider.fallback_pending`. The gate waits for a choice
+     * (manual pick or auto-countdown) before proceeding. This lets the UI show
+     * a modal with a countdown and manual model selection on every fallback hop.
+     *
+     * Returns the chosen model reference, or `null` to auto-switch to the next
+     * candidate (countdown expired or user accepted the default).
+     */
+    fallbackGate?: FallbackGateFn | undefined;
+    /**
+     * Seconds the UI counts down before auto-switching. Default: 7.
+     */
+    fallbackGateSeconds?: number | undefined;
 }
+/**
+ * Gate function invoked when the fallback chain is about to engage. It should
+ * emit `provider.fallback_pending` on the supplied `events` bus — carrying a
+ * unique `requestId` and a `timestamp` in the payload — wait for the UI's
+ * `provider.fallback_choice` emission echoing that `requestId` (or the
+ * countdown), and resolve with the selected model or `null` to accept the
+ * default next. See `createFallbackGate` in the CLI wiring for a reference
+ * implementation.
+ */
+export type FallbackGateFn = (params: {
+    events: EventBus;
+    sessionId: string | undefined;
+    from: {
+        providerId: string;
+        model: string;
+    };
+    status: number;
+    candidates: Array<{
+        providerId: string;
+        model: string;
+    }>;
+    autoSwitchSeconds: number;
+    /**
+     * Correlation id owned by the caller (the fallback-model extension). The
+     * gate MUST echo it in `provider.fallback_pending` so the UI's choice
+     * reply and the eventual `provider.fallback` completion event share the
+     * same id — clients use it to match the modal to the right gate when
+     * parallel requests fail on the same primary.
+     */
+    requestId: string;
+}) => Promise<{
+    providerId: string;
+    model: string;
+} | null>;
 export declare function fallbackProfileChain(config: Config, profileName: string | undefined): string[];
 export declare function smartDefaultFallbackChain(config: Config): string[];
 /**

package/dist/core/index.d.ts

@@ -1,15 +1,17 @@
 export { Agent, type RunResult, type UserInputPayload, } from './agent.js';
-export { createDefaultPipelines, type AgentInit, type AgentInput, type AgentPipelines, type ToolCallPipelinePayload, } from './agent-types.js';
-export { Context, type ContextInit, type RunOptions, type TodoItem } from './context.js';
-export { ConversationState, type ReadonlyConversationState, type StateChange, type StateChangeHandler, wrapAsState, } from './conversation-state.js';
-export { InputBuilder, type InputBuilderEvent, type InputBuilderOptions, } from './input-builder.js';
+export { type AgentInit, type AgentInput, type AgentPipelines, createDefaultPipelines, type ToolCallPipelinePayload, } from './agent-types.js';
 export { buildBtwBlock, consumeBtwNotes, pendingBtwCount, setBtwNote, } from './btw.js';
+export { Context, type ContextInit, type ProviderMemoryEvidence, type RunOptions, type TodoItem, } from './context.js';
 export { type ContinuationInput, type ContinuationSource, detectContinueIntent, type ResolvedContinuation, resolveContinuation, } from './continue-intent.js';
-export { createFallbackModelExtension, effectiveFallbackChain, fallbackProfileChain, smartDefaultFallbackChain, } from './fallback-model.js';
+export { ConversationState, type ReadonlyConversationState, type StateChange, type StateChangeHandler, wrapAsState, } from './conversation-state.js';
+export { createFallbackModelExtension, effectiveFallbackChain, type FallbackGateFn, type FallbackModelDeps, fallbackProfileChain, smartDefaultFallbackChain, } from './fallback-model.js';
 export { FallbackProfileManager } from './fallback-profile-manager.js';
-export { formatModelRef, normalizeModelRef, parseModelRef, type ModelRef, } from './model-ref.js';
-export { DefaultSystemPromptBuilder, type DefaultSystemPromptBuilderOptions, type SystemBlockSource, } from './system-prompt-builder.js';
-export type { SystemInstructionVariant } from './instruction-bundle.js';
-export { setQueuedMessagesSnapshot } from './queued-messages.js';
+export { InputBuilder, type InputBuilderEvent, type InputBuilderOptions, } from './input-builder.js';
+export { type InstructionBundle, type InstructionBundlePaths, loadInstructionBundle, type SystemInstructionVariant, } from './instruction-bundle.js';
+export { type InstructionTemplateContext, renderInstructionLayer, } from './instruction-template.js';
+export { formatModelRef, type ModelRef, normalizeModelRef, parseModelRef, } from './model-ref.js';
+export { clearPendingNextSteps, hasNextStepsTag, MAX_PENDING_NEXT_STEPS, maybeAppendPendingNextSteps, type PendingNextStep, readPendingNextSteps, renderNextStepsBlock, writePendingNextSteps, } from './next-steps-slot.js';
 export { runProviderWithRetry } from './provider-runner.js';
+export { setQueuedMessagesSnapshot } from './queued-messages.js';
+export { DefaultSystemPromptBuilder, type DefaultSystemPromptBuilderOptions, type SystemBlockSource, } from './system-prompt-builder.js';
 //# sourceMappingURL=index.d.ts.map