@wrongstack/core 0.300.0 → 0.302.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/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/index.d.ts

@@ -1,16 +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 { 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 { 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 { setQueuedMessagesSnapshot } from './queued-messages.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