@songsid/agend 2.2.0-alpha.9 → 2.2.0-beta.10

package/dist/outbound-handlers.d.ts

@@ -6,7 +6,10 @@ import type { RoutingEngine } from "./routing-engine.js";
 import type { InstanceLifecycle } from "./instance-lifecycle.js";
 import type { EventLog } from "./event-log.js";
 import { type DeliveryStatusPage, type DeliveryStatusSelector } from "./delivery-outbox.js";
+import type { z } from "zod";
 import type { InteractionSnapshot } from "./backend/types.js";
+import type { CarryResult } from "./backend/claude-carry.js";
+import { UpdateInstanceConfigArgs } from "./outbound-schemas.js";
 /** Shared context available to all outbound tool handlers. */
 export interface OutboundContext {
     readonly dataDir: string;
@@ -39,6 +42,12 @@ export interface OutboundContext {
     restartSingleInstance(name: string, opts?: {
         freshStart?: boolean;
         explicit?: boolean;
+        carry?: {
+            backend: string;
+            from: string | null;
+            to: string | null;
+            result?: CarryResult | null;
+        };
     }): Promise<void>;
     /** Phase 2b: an operator wake that respects the warm hard cap (FleetManager.explicitWake). */
     explicitWake?(name: string, timeoutMs?: number): Promise<void>;
@@ -55,10 +64,13 @@ export interface OutboundContext {
         kind: string;
         correlationId: string;
         payload: Record<string, unknown>;
+        forwards?: readonly string[];
+        requestedKind?: string;
     }): {
         deliveryId: string;
         state: string;
         duplicate: boolean;
+        kind?: string;
     };
     /** Read-only status query scoped to a server-authenticated source/target. */
     queryDurableDeliveryStatus?(callerInstance: string, selector: DeliveryStatusSelector): DeliveryStatusPage;
@@ -84,6 +96,8 @@ export interface OutboundContext {
     /** Post a notice into an instance's own topic (used to report failed deliveries). */
     notifyInstanceTopic?(instanceName: string, text: string): void;
     sendCancelButton?(instanceName: string, correlationId?: string): Promise<void>;
+    /** Push a web UI event; a "message" is recorded in the instance's web chat history (#1565). */
+    emitSseEvent?(event: string, data: unknown): void;
     clearCancelButton?(instanceName: string): void;
     clearCancelButtonByCorrelation?(correlationId: string): void;
     getInstanceInteraction?(name: string): InteractionSnapshot | null;
@@ -92,6 +106,17 @@ export interface OutboundContext {
     getActiveUsageProviderIds?(): ReadonlySet<string>;
     /** Effective process state used to annotate cross-instance delivery results. */
     getInstanceStatus?(name: string): "running" | "paused" | "stopped" | "crashed";
+    /** #1808: whether `backend` takes this model name (the rule /backend applies too); `choices`: what it offers. */
+    backendModelVerdict?(instanceName: string, backend: string, model: string, opts?: {
+        provider: string | null;
+    }): {
+        ok: true;
+    } | {
+        ok: false;
+        choices: string[];
+    };
+    /** #1808: `/effort`'s levels on a backend this instance may move to, for the model that will run there; empty: none. */
+    backendEffortLevels?(instanceName: string, backend: string, model: string | null): string[];
     resolveInstanceModel?(name: string): {
         model: string;
         source: "instance" | "fleet-default" | "classic" | "cli-default" | "unresolved";
@@ -124,7 +149,82 @@ export declare function setCrossInstanceRetryForTests(cfg: {
     retries: number;
     intervalMs: number;
 } | null): void;
+/**
+ * What update_instance_config merges into an instance — and, in-process only, what chat `/backend` (#1806) needs on
+ * top: `effort`, and `null` for `model`/`effort` meaning "back to the inherited value". The MCP schema stays as it is,
+ * so an agent can do neither.
+ */
+export type InstanceConfigPatch = Omit<z.infer<typeof UpdateInstanceConfigArgs>["config"], "model"> & {
+    model?: string | null;
+    effort?: string | null;
+};
+/**
+ * update_instance_config's write: one validated config write, rolled back whole on a refusal, then one relaunch when
+ * the backend (fresh, #1217), a credential profile or backend_options changed. Answers through `respond` like the tool.
+ */
+export declare function applyInstanceConfigPatch(ctx: OutboundContext, name: string, patch: InstanceConfigPatch, respond: Respond): void;
 /** Long enough for the relaunched CLI to be listening; matches replace_instance. */
 export declare const PROFILE_HANDOVER_SETTLE_MS = 3000;
+/**
+ * #1692: the one creation of a team — create_team (agents) and POST /ui/teams (the web) both come here. Members must be
+ * instances fleet.yaml defines (own keys; repeats dropped); an existing team is never overwritten (409); a name every
+ * object already has (`__proto__`, `constructor`, `toString`…) is not a team name. The team and its save are one: a
+ * save that throws removes it again (500).
+ */
+export declare function commitTeamCreate(fleetConfig: {
+    instances: Record<string, unknown>;
+    teams?: Record<string, {
+        members: string[];
+        description?: string;
+    }>;
+} | null, args: {
+    name: string;
+    members: string[];
+    description?: string;
+}, save: () => void): {
+    ok: true;
+    result: {
+        created: string;
+        members: string[];
+    };
+} | {
+    ok: false;
+    status: 400 | 409 | 500;
+    error: string;
+};
+/**
+ * #1689: the one update of a team — update_team (agents) and PATCH /ui/teams/<name> (the web) both come here. Own keys
+ * only: a team or an instance is one fleet.yaml defines (`__proto__` and `constructor` are not); nothing changes unless
+ * everything is valid. `description`: "" clears it. Renaming is not an update (the org chart and agents name teams).
+ * The caller saves fleet.yaml after an ok.
+ */
+export declare function applyTeamUpdate(fleetConfig: {
+    instances: Record<string, unknown>;
+    teams?: Record<string, {
+        members: string[];
+        description?: string;
+    }>;
+} | null, args: {
+    name: string;
+    add?: string[];
+    remove?: string[];
+    description?: string;
+}): {
+    ok: true;
+    result: {
+        name: string;
+        members: string[];
+        description: string | null;
+    };
+} | {
+    ok: false;
+    status: 400 | 404 | 500;
+    error: string;
+};
+/**
+ * #1689 review: the update and its save as one — a save that fails (an I/O error) puts the team back as it was, so the
+ * live fleet never differs from fleet.yaml; that is a 500 (the input was fine), not a 400.
+ */
+export declare function commitTeamUpdate(fleetConfig: Parameters<typeof applyTeamUpdate>[0], args: Parameters<typeof applyTeamUpdate>[1], save: () => void): ReturnType<typeof applyTeamUpdate>;
 export declare const outboundHandlers: Map<string, Handler>;
 export {};