@letta-ai/letta-code 0.34.2 → 0.34.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letta-ai/letta-code",
-  "version": "0.34.2",
+  "version": "0.34.4",
   "lettaStartupLogProtocol": 1,
   "description": "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
   "type": "module",

package/scripts/source-file-size-baseline.json

@@ -19,12 +19,12 @@
   "src/cli/mods/local-mod-loader.test.ts": 1043,
   "src/cli/reflection-transcript.test.ts": 1084,
   "src/cli/subcommands/skills.ts": 1264,
-  "src/headless.ts": 4780,
+  "src/headless.ts": 4778,
   "src/hooks/integration.test.ts": 1147,
   "src/index.ts": 2577,
   "src/mods/learning-harness.ts": 2434,
   "src/mods/mod-engine.test.ts": 2153,
-  "src/mods/mod-engine.ts": 1838,
+  "src/mods/mod-engine.ts": 1836,
   "src/mods/package-installer.test.ts": 1248,
   "src/mods/package-installer.ts": 1201,
   "src/mods/package-registry.ts": 1033,
@@ -33,9 +33,9 @@
   "src/providers/chatgpt-usage-service.ts": 1112,
   "src/settings-manager.test.ts": 1635,
   "src/settings-manager.ts": 2092,
-  "src/tools/manager.ts": 2625,
+  "src/tools/manager.ts": 2610,
   "src/tools/tool-execution-context.test.ts": 1092,
-  "src/types/protocol_v2.ts": 2542,
+  "src/types/protocol_v2.ts": 2548,
   "src/websocket/listen-client-concurrency.test.ts": 2557,
   "src/websocket/listen-client-protocol.test.ts": 5707,
   "src/websocket/listener/commands/memory.ts": 1114,

package/skills/creating-mods/references/events.md

@@ -226,6 +226,8 @@ letta.events.on("turn_start", (event) => {
 
 If multiple handlers cancel, the first valid cancel reason wins. A valid reason is a non-empty string after trimming. Cancellation does not synthesize an assistant response or tool result; it only tells the host not to submit this turn.
 
+Don't cancel every turn because the guard's own dependency failed (for example, a missing bootstrap file); that locks the user out until they edit or remove the mod and run `/reload`. Guard the risky tool with `tool_start` instead.
+
 Handlers run in registration order. Later handlers see the current input after earlier mutations/returns. If a handler throws, its partial `event.input` mutation is rolled back and the error is recorded as a mod diagnostic.
 
 `turn_start` is intentionally a trusted local mod point: it can rewrite user messages, approval results, and ordering. Keep transforms focused and unsurprising.

package/skills/self-configuration/SKILL.md

@@ -50,8 +50,10 @@ If a broken model or prompt prevents the agent from completing a turn, recover o
 Local settings, server state, and the current process are different sources of truth. Inspect the layer you intend to change before writing it.
 
 - `letta model list [--byok | --hosted]` lists available models.
-- `letta model set [model_handle] [--reasoning <reasoning-option>] [--default]` changes the current conversation's model or reasoning; add `--default` only when the user asks for the agent default.
-- `letta model get [--default]` gets the current model configuration; `--default` gets the agent's default configuration.
+- `letta model set [model_handle] [--reasoning <reasoning-option>] [--model-settings <json>] [--default]` changes the current conversation's model, reasoning, or individual `model_settings` fields; add `--default` only when the user asks for the agent default.
+- `letta model get [--default]` gets the current model configuration, including the full redacted `model_settings`; `--default` gets the agent's default configuration.
+
+`letta model` reads and writes through the active backend, so it works the same on every backend. Prefer it over the REST helper scripts for anything model-related.
 
 ### Account credits and model quota
 
@@ -77,14 +79,12 @@ Use the secret-safe local/runtime report for harness settings, permissions, and
 python3 <SKILL_DIR>/scripts/show_config.py --cwd "$PWD"
 ```
 
-Before changing server state, the targeted helper can also read either scope without printing full system prompts or credentials:
+Read each model scope with `letta model get` before changing it:
 
 ```bash
-npx tsx <SKILL_DIR>/scripts/update-agent-settings.ts \
-  --target agent --agent-id "$AGENT_ID" --show
-
-npx tsx <SKILL_DIR>/scripts/update-agent-settings.ts \
-  --target conversation --conversation-id "$CONVERSATION_ID" --show
+letta model get                               # current conversation (or agent if none)
+letta model get --default                     # agent default
+letta model get --conversation "$CONVERSATION_ID"
 ```
 
 Do not infer an agent default from one conversation or infer a conversation override from the agent. Report both when diagnosing model or context differences.
@@ -116,7 +116,27 @@ Do not use API system-prompt replacement for ordinary learning. That can clobber
 
 ## Server-side agent and conversation settings
 
-Server fields control model execution and agent metadata. Use the conversation endpoint for model changes. Use the agent endpoint only when the user asks for the agent default.
+Server fields control model execution and agent metadata. Change the current conversation for model changes. Change the agent default only when the user asks for it.
+
+### Model and model settings
+
+Use `letta model` for the model handle, reasoning level, and any `model_settings` field (for example the output-token limit, `temperature`, or `parallel_tool_calls`). It goes through the active backend, so it needs no extra credentials or base URL.
+
+```bash
+letta model set "openai/gpt-5.2"                          # select a model (applies its defaults)
+letta model set --reasoning high                          # change reasoning only
+letta model set --model-settings '{"max_tokens":16384}'          # use the key `letta model get` shows
+letta model set --model-settings '{"temperature":0.2}' --default   # agent default
+letta model get                                           # verify
+```
+
+`--model-settings` takes a JSON object and shallow-merges it into the target's current `model_settings` (the conversation override when a conversation is targeted, otherwise the agent default). It keeps the model and every field you do not name. Keys are written as given, so use the field names that `letta model get` shows for the target; for example the output-token limit is stored as `max_tokens` on some backends and `max_output_tokens` on others. Nested objects such as `reasoning` are replaced as a whole, so include every nested key you want to keep. With a handle or `--reasoning`, the model selection is applied first and the given fields are merged on top. Selecting a new handle resets settings to that model's defaults, so reapply custom fields in the same command if needed.
+
+Provider reasoning fields differ. Read [`references/model-settings.md`](references/model-settings.md) before changing reasoning or provider-specific settings.
+
+### REST helper for other fields
+
+`scripts/update-agent-settings.ts` covers fields `letta model` does not: `context_window_limit`, name, description, and system prompt replacement. It talks to the REST API at `LETTA_BASE_URL` and requires `LETTA_API_KEY`, so it only works against a server that exposes the REST API; it does not work on the embedded local backend.
 
 Required environment for live API writes:
 
@@ -135,13 +155,12 @@ The scripts in this skill default to `AGENT_ID`, `CONVERSATION_ID`, and `LETTA_B
 npx tsx <SKILL_DIR>/scripts/update-agent-settings.ts --help
 ```
 
-Patch the current conversation for a model/settings change:
+Patch the current conversation's context window limit:
 
 ```bash
 npx tsx <SKILL_DIR>/scripts/update-agent-settings.ts \
   --target conversation \
   --conversation-id "$CONVERSATION_ID" \
-  --model "openai/gpt-5.2" \
   --context-window-limit 64000 \
   --dry-run
 ```
@@ -152,7 +171,6 @@ Patch the agent default only when the user asks for it:
 npx tsx <SKILL_DIR>/scripts/update-agent-settings.ts \
   --target agent \
   --agent-id "$AGENT_ID" \
-  --model "openai/gpt-5.2" \
   --context-window-limit 64000
 ```
 
@@ -176,31 +194,7 @@ npx tsx <SKILL_DIR>/scripts/update-agent-settings.ts \
   --dry-run
 ```
 
-Do not patch `llm_config` directly. Use `model`, `context_window_limit`, and `model_settings`. For metadata, use `name` and `description`. Then read back the agent or conversation and verify the returned `llm_config.context_window`, `model_settings`, and metadata fields.
-
-### Model settings
-
-`model_settings` is usually replacement-style. Fetch the current object first and preserve fields you still need, or pass `--merge-model-settings`. Merge dry runs fetch current state and require `LETTA_API_KEY` because they preview preserved fields, not just the local patch fragment.
-
-```bash
-cat > /tmp/model-settings.json <<'JSON'
-{
-  "provider_type": "openai",
-  "parallel_tool_calls": true,
-  "reasoning": { "reasoning_effort": "medium" }
-}
-JSON
-
-npx tsx <SKILL_DIR>/scripts/update-agent-settings.ts \
-  --target agent \
-  --agent-id "$AGENT_ID" \
-  --model "openai/gpt-5.2" \
-  --model-settings-file /tmp/model-settings.json \
-  --merge-model-settings \
-  --dry-run
-```
-
-Provider reasoning fields differ. Read [`references/model-settings.md`](references/model-settings.md) before changing reasoning or provider-specific settings.
+Do not patch `llm_config` directly. Use `letta model` for the model and `model_settings`, `context_window_limit` for the context limit, and `name`/`description` for metadata. Then read back the agent or conversation (`letta model get` for model fields) and verify the result.
 
 ### Compaction settings
 
@@ -447,7 +441,7 @@ Do not start a second listener for the same channel accounts merely to apply new
 
 | Script | Purpose |
 | --- | --- |
-| `scripts/update-agent-settings.ts` | Show or patch agent/conversation server settings safely |
+| `scripts/update-agent-settings.ts` | Show or patch REST-only agent/conversation fields (context limit, name, description, system prompt); needs a REST server and `LETTA_API_KEY` |
 | `scripts/update-compaction-prompt.ts` | Preserve existing compaction settings while replacing the prompt |
 | `scripts/add_permission.py` | Add allow/deny/ask/alwaysAsk rules to a chosen settings scope |
 | `scripts/show_config.py` | Show runtime/local settings without dumping secret values |

package/dist/types/channels/gateway-assistant-relay.d.ts

@@ -1,37 +0,0 @@
-import type { StopReasonType, StreamDeltaMessage } from "../types/app-server-protocol";
-import type { MessageChannelIdempotencyScope } from "./message-channel-idempotency";
-import type { ChannelTurnSource } from "./types";
-export interface GatewayAssistantTextAccumulatorState {
-    currentMessageId: string | null;
-    currentText: string;
-    deltaKeys: string[];
-    finalizedMessageIds: string[];
-}
-export interface FinalizedGatewayAssistantMessage {
-    messageId: string;
-    text: string;
-}
-export declare class GatewayAssistantTextAccumulator {
-    private currentMessageId;
-    private currentText;
-    private readonly deltaKeys;
-    private readonly finalizedMessageIds;
-    constructor(state?: GatewayAssistantTextAccumulatorState);
-    snapshot(): GatewayAssistantTextAccumulatorState;
-    handleDelta(message: StreamDeltaMessage): FinalizedGatewayAssistantMessage[];
-    finalizeCurrent(): FinalizedGatewayAssistantMessage | null;
-}
-export declare function relayFinalizedAssistantMessage(options: {
-    message: FinalizedGatewayAssistantMessage;
-    sources: ChannelTurnSource[];
-    idempotencyScope: MessageChannelIdempotencyScope;
-    relay?: (options: {
-        text: string;
-        sources: ChannelTurnSource[];
-        idempotencyScope: MessageChannelIdempotencyScope;
-    }) => void | Promise<void>;
-}): void | Promise<void>;
-export declare function stopReasonFromDelta(message: StreamDeltaMessage): StopReasonType | null;
-export declare function runIdFromDelta(message: StreamDeltaMessage): string | undefined;
-export declare function channelTurnOutcome(stopReason: StopReasonType): "completed" | "error" | "cancelled";
-//# sourceMappingURL=gateway-assistant-relay.d.ts.map

package/dist/types/channels/gateway-assistant-relay.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gateway-assistant-relay.d.ts","sourceRoot":"","sources":["../../../src/channels/gateway-assistant-relay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,WAAW,oCAAoC;IACnD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,gCAAgC;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,+BAA+B;IAC1C,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAc;gBAEtC,KAAK,CAAC,EAAE,oCAAoC;IAOxD,QAAQ,IAAI,oCAAoC;IAShD,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,gCAAgC,EAAE;IA2C5E,eAAe,IAAI,gCAAgC,GAAG,IAAI;CAS3D;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,OAAO,EAAE,gCAAgC,CAAC;IAC1C,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,gBAAgB,EAAE,8BAA8B,CAAC;IACjD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,iBAAiB,EAAE,CAAC;QAC7B,gBAAgB,EAAE,8BAA8B,CAAC;KAClD,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,kBAAkB,GAC1B,cAAc,GAAG,IAAI,CAOvB;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,kBAAkB,GAC1B,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,cAAc,GACzB,WAAW,GAAG,OAAO,GAAG,WAAW,CAKrC"}

package/dist/types/channels/gateway-registration-policy.d.ts

@@ -1,14 +0,0 @@
-import type { RuntimeScope, RuntimeStartResponseMessage } from "../types/app-server-protocol";
-import type { ChannelGatewayHooks, ChannelGatewayModelStatus } from "./gateway-types";
-import type { ChannelTurnSource } from "./types";
-export declare function prepareGatewayRegistrationPolicy(options: {
-    hooks: ChannelGatewayHooks;
-    runtime: RuntimeScope;
-    sources: ChannelTurnSource[];
-    override?: boolean;
-}): Promise<{
-    automaticRelay: boolean;
-    tool: Awaited<ReturnType<ChannelGatewayHooks["buildExternalTool"]>>;
-}>;
-export declare function modelStatusFromRuntimeStart(response: RuntimeStartResponseMessage, runtime: RuntimeScope): ChannelGatewayModelStatus;
-//# sourceMappingURL=gateway-registration-policy.d.ts.map

package/dist/types/channels/gateway-registration-policy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gateway-registration-policy.d.ts","sourceRoot":"","sources":["../../../src/channels/gateway-registration-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,2BAA2B,EAC5B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,wBAAsB,gCAAgC,CAAC,OAAO,EAAE;IAC9D,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC;IACV,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;CACrE,CAAC,CAeD;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,2BAA2B,EACrC,OAAO,EAAE,YAAY,GACpB,yBAAyB,CAiB3B"}

package/dist/types/channels/gateway-runtime-registration.d.ts

@@ -1,12 +0,0 @@
-import type { RuntimeStartExternalToolsGroup } from "../types/app-server-protocol";
-import type { GatewayRuntimeState } from "./gateway-runtime-state";
-import type { ChannelGatewayClient, ChannelGatewayDelivery, ChannelGatewayHooks } from "./gateway-types";
-export declare function performGatewayRuntimeRegistration(options: {
-    client: ChannelGatewayClient;
-    hooks: ChannelGatewayHooks;
-    state: GatewayRuntimeState;
-    delivery: ChannelGatewayDelivery;
-    policyOverride?: boolean;
-    externalToolsOverride?: readonly RuntimeStartExternalToolsGroup[];
-}): Promise<boolean>;
-//# sourceMappingURL=gateway-runtime-registration.d.ts.map

package/dist/types/channels/gateway-runtime-registration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gateway-runtime-registration.d.ts","sourceRoot":"","sources":["../../../src/channels/gateway-runtime-registration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAKlF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AAEzB,wBAAsB,iCAAiC,CAAC,OAAO,EAAE;IAC/D,MAAM,EAAE,oBAAoB,CAAC;IAC7B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,EAAE,sBAAsB,CAAC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qBAAqB,CAAC,EAAE,SAAS,8BAA8B,EAAE,CAAC;CACnE,GAAG,OAAO,CAAC,OAAO,CAAC,CAsEnB"}

package/dist/types/channels/gateway-runtime-state.d.ts

@@ -1,48 +0,0 @@
-import type { RuntimeScope } from "../types/app-server-protocol";
-import type { GatewayAssistantTextAccumulator } from "./gateway-assistant-relay";
-import type { GatewayToolScope } from "./gateway-runtime-tool-scopes";
-import type { ChannelGatewayModelStatus, ChannelGatewayRichDraft } from "./gateway-types";
-import type { MessageChannelIdempotencyScope } from "./message-channel-idempotency";
-import type { createChannelTurnProgressBuilder } from "./progress-builder";
-import type { ChannelTurnSource } from "./types";
-export type ActiveGatewayTurn = {
-    batchId: string;
-    routingSources: ChannelTurnSource[];
-    lifecycleSources: ChannelTurnSource[];
-    progress: ReturnType<typeof createChannelTurnProgressBuilder>;
-    richDraft: ChannelGatewayRichDraft | null;
-    runId?: string;
-    assistantText: GatewayAssistantTextAccumulator;
-    idempotencyScope: MessageChannelIdempotencyScope;
-    relayEligible: boolean;
-    toolScopes: GatewayToolScope[];
-};
-export type GatewayRuntimeState = {
-    runtime: RuntimeScope;
-    pendingSourcesByClientMessageId: Map<string, {
-        sources: ChannelTurnSource[];
-        disposition: "submitting" | "queued";
-        automaticRelay: boolean;
-        toolScope?: GatewayToolScope;
-        removalDisposition?: "dequeued" | "cancelled";
-    }>;
-    active: ActiveGatewayTurn | null;
-    registrationSignature: string | null;
-    registration: Promise<void> | null;
-    routedSources: ChannelTurnSource[];
-    replayedControlRequestIds: Set<string>;
-    submissionQueue: Promise<void>;
-    hookQueue: Promise<void> | null;
-    acceptedClientMessageIds: Set<string>;
-    modelStatus: ChannelGatewayModelStatus | null;
-};
-export declare function gatewayRuntimeKey(runtime: RuntimeScope<string | null>): string;
-export declare function hasAgentRuntime<T extends {
-    runtime?: RuntimeScope<string | null> | null;
-}>(value: T): value is T & {
-    runtime: RuntimeScope;
-};
-export declare function hasGatewayRuntimeWork(state: GatewayRuntimeState | undefined): boolean;
-export declare function rememberAcceptedClientMessageId(state: GatewayRuntimeState, clientMessageId: string): void;
-export declare function remainingGatewaySources(state: GatewayRuntimeState): ChannelTurnSource[];
-//# sourceMappingURL=gateway-runtime-state.d.ts.map

package/dist/types/channels/gateway-runtime-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gateway-runtime-state.d.ts","sourceRoot":"","sources":["../../../src/channels/gateway-runtime-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EACV,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAIjD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,gBAAgB,EAAE,iBAAiB,EAAE,CAAC;IACtC,QAAQ,EAAE,UAAU,CAAC,OAAO,gCAAgC,CAAC,CAAC;IAC9D,SAAS,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,+BAA+B,CAAC;IAC/C,gBAAgB,EAAE,8BAA8B,CAAC;IACjD,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,YAAY,CAAC;IACtB,+BAA+B,EAAE,GAAG,CAClC,MAAM,EACN;QACE,OAAO,EAAE,iBAAiB,EAAE,CAAC;QAC7B,WAAW,EAAE,YAAY,GAAG,QAAQ,CAAC;QACrC,cAAc,EAAE,OAAO,CAAC;QACxB,SAAS,CAAC,EAAE,gBAAgB,CAAC;QAC7B,kBAAkB,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;KAC/C,CACF,CAAC;IACF,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACnC,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,yBAAyB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,wBAAwB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,WAAW,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAC/C,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,GACnC,MAAM,CAER;AAED,wBAAgB,eAAe,CAC7B,CAAC,SAAS;IAAE,OAAO,CAAC,EAAE,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;CAAE,EAC1D,KAAK,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG;IAAE,OAAO,EAAE,YAAY,CAAA;CAAE,CAElD;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,mBAAmB,GAAG,SAAS,GACrC,OAAO,CAIT;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,mBAAmB,EAC1B,eAAe,EAAE,MAAM,GACtB,IAAI,CAON;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,mBAAmB,GACzB,iBAAiB,EAAE,CAOrB"}

package/dist/types/channels/gateway-runtime-tool-scopes.d.ts

@@ -1,26 +0,0 @@
-import type { ExternalToolDefinitionPayload, RuntimeExternalToolsUpdateGroup, RuntimeScope, RuntimeStartExternalToolsGroup } from "../types/app-server-protocol";
-import type { ChannelGatewayClient, ChannelGatewayToolScopeState } from "./gateway-types";
-import type { ChannelTurnSource } from "./types";
-export type GatewayToolScope = ChannelGatewayToolScopeState;
-export declare class GatewayRuntimeToolScopes {
-    private readonly client;
-    private readonly states;
-    private readonly retryTimers;
-    private closed;
-    constructor(client: ChannelGatewayClient);
-    create(runtime: RuntimeScope, sources: ChannelTurnSource[], automaticRelay: boolean, tool: ExternalToolDefinitionPayload | null): GatewayToolScope;
-    retain(scope: GatewayToolScope): void;
-    detach(scope: GatewayToolScope): GatewayToolScope;
-    release(scope: GatewayToolScope): void;
-    resolve(runtime: RuntimeScope<string | null>, scopeId: string): GatewayToolScope | null;
-    selection(scope: GatewayToolScope): string[];
-    hasRetainedScopes(runtime: RuntimeScope<string | null>): boolean;
-    registrationGroups(runtime: RuntimeScope<string | null>, includeUnscoped: boolean): readonly RuntimeStartExternalToolsGroup[];
-    setDesiredUnscoped(runtime: RuntimeScope<string | null>, groups: readonly RuntimeStartExternalToolsGroup[]): void;
-    updateDesiredUnscoped(updates: readonly RuntimeExternalToolsUpdateGroup[], isBusy: (runtime: RuntimeScope<string | null>) => boolean): Promise<void>;
-    flushWhenIdle(runtime: RuntimeScope<string | null>, isBusy: () => boolean, schedule: (task: () => Promise<void>) => Promise<void>): void;
-    forgetRuntime(runtime: RuntimeScope<string | null>): void;
-    close(): void;
-    private getState;
-}
-//# sourceMappingURL=gateway-runtime-tool-scopes.d.ts.map

package/dist/types/channels/gateway-runtime-tool-scopes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gateway-runtime-tool-scopes.d.ts","sourceRoot":"","sources":["../../../src/channels/gateway-runtime-tool-scopes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,+BAA+B,EAC/B,YAAY,EACZ,8BAA8B,EAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,oBAAoB,EACpB,4BAA4B,EAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAQjD,MAAM,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AAQ5D,qBAAa,wBAAwB;IAKvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,MAAM,CAAS;gBAEM,MAAM,EAAE,oBAAoB;IAEzD,MAAM,CACJ,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,iBAAiB,EAAE,EAC5B,cAAc,EAAE,OAAO,EACvB,IAAI,EAAE,6BAA6B,GAAG,IAAI,GACzC,gBAAgB;IAenB,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAIrC,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB;IAKjD,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAItC,OAAO,CACL,OAAO,EAAE,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,EACpC,OAAO,EAAE,MAAM,GACd,gBAAgB,GAAG,IAAI;IAI1B,SAAS,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,EAAE;IAI5C,iBAAiB,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,OAAO;IAIhE,kBAAkB,CAChB,OAAO,EAAE,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,EACpC,eAAe,EAAE,OAAO,GACvB,SAAS,8BAA8B,EAAE;IAS5C,kBAAkB,CAChB,OAAO,EAAE,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,EACpC,MAAM,EAAE,SAAS,8BAA8B,EAAE,GAChD,IAAI;IAID,qBAAqB,CACzB,OAAO,EAAE,SAAS,+BAA+B,EAAE,EACnD,MAAM,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,OAAO,GACxD,OAAO,CAAC,IAAI,CAAC;IAoChB,aAAa,CACX,OAAO,EAAE,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,EACpC,MAAM,EAAE,MAAM,OAAO,EACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GACrD,IAAI;IA4BP,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI;IAIzD,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,QAAQ;CASjB"}

package/dist/types/channels/gateway-types.d.ts

@@ -1,71 +0,0 @@
-import type { MessageCreate } from "@letta-ai/letta-client/resources/agents/agents";
-import type { ExternalToolCallRequestMessage, ExternalToolCallResult, ExternalToolDefinitionPayload, InputAcceptedResponseMessage, InputCommand, RuntimeExternalToolsUpdateGroup, RuntimeExternalToolsUpdateResponseMessage, RuntimeScope, RuntimeStartCommand, RuntimeStartExternalToolsGroup, RuntimeStartResponseMessage, WsProtocolMessage } from "../types/app-server-protocol";
-import type { GatewayAssistantTextAccumulatorState } from "./gateway-assistant-relay";
-import type { MessageChannelIdempotencyScope, MessageChannelIdempotencyState } from "./message-channel-idempotency";
-import type { ChannelControlRequestEvent, ChannelDefaultPermissionMode, ChannelTurnLifecycleEvent, ChannelTurnProgressEvent, ChannelTurnSource } from "./types";
-export interface ChannelGatewayClient {
-    close(): void;
-    onMessage(listener: (message: WsProtocolMessage) => void): () => void;
-    onExternalToolCall(handler: (request: ExternalToolCallRequestMessage) => Promise<ExternalToolCallResult> | ExternalToolCallResult): () => void;
-    submitInput(command: Omit<InputCommand, "type">): Promise<InputAcceptedResponseMessage>;
-    runtimeStart(options: Omit<RuntimeStartCommand, "type" | "request_id"> & {
-        request_id?: string;
-    }): Promise<RuntimeStartResponseMessage>;
-    runtimeExternalToolsUpdate(options: {
-        updates: readonly RuntimeExternalToolsUpdateGroup[];
-    }): Promise<RuntimeExternalToolsUpdateResponseMessage>;
-}
-export interface ChannelGatewayHooks {
-    buildExternalTool(runtime: RuntimeScope, sources: ChannelTurnSource[], policy?: {
-        automaticRelay: boolean;
-    }): Promise<ExternalToolDefinitionPayload | null>;
-    resolveAssistantRelayPolicy?(runtime: RuntimeScope, sources: ChannelTurnSource[]): boolean | Promise<boolean>;
-    executeExternalTool(request: ExternalToolCallRequestMessage, sources: ChannelTurnSource[], idempotencyScope?: MessageChannelIdempotencyScope | null): Promise<ExternalToolCallResult> | ExternalToolCallResult;
-    relayAssistantText?(options: {
-        text: string;
-        sources: ChannelTurnSource[];
-        idempotencyScope: MessageChannelIdempotencyScope;
-    }): void | Promise<void>;
-    onLifecycle(event: ChannelTurnLifecycleEvent): void | Promise<void>;
-    onProgress(event: ChannelTurnProgressEvent): void | Promise<void>;
-    onControlRequest(event: ChannelControlRequestEvent): void | Promise<void>;
-    createRichDraft?(options: {
-        batchId: string;
-        sources: ChannelTurnSource[];
-    }): ChannelGatewayRichDraft | null;
-}
-export interface ChannelGatewayDelivery {
-    runtime: RuntimeScope;
-    content: MessageCreate["content"];
-    sources: ChannelTurnSource[];
-    clientMessageId: string;
-    defaultPermissionMode?: ChannelDefaultPermissionMode;
-}
-export interface ChannelGatewayActiveTurnState {
-    assistantText: GatewayAssistantTextAccumulatorState;
-    idempotency: MessageChannelIdempotencyState;
-    /** Effective policy captured when this turn was registered. */
-    automaticRelay?: boolean;
-    /** Immutable scoped tool registrations retained across ownership handoff. */
-    toolScopes?: ChannelGatewayToolScopeState[];
-}
-export interface ChannelGatewayToolScopeState {
-    id: string;
-    runtime: RuntimeScope;
-    sources: ChannelTurnSource[];
-    automaticRelay: boolean;
-    group?: RuntimeStartExternalToolsGroup;
-}
-export type ChannelGatewayHandoffDelivery = Omit<ChannelGatewayDelivery, "content"> & {
-    activeTurnState?: ChannelGatewayActiveTurnState;
-};
-export interface ChannelGatewayRichDraft {
-    handleDelta(delta: import("../types/app-server-protocol").StreamDeltaMessage["delta"]): void;
-    flushPending(): Promise<void>;
-    dispose(): void;
-}
-export interface ChannelGatewayModelStatus {
-    modelHandle: string | null;
-    scope: "agent" | "conversation";
-}
-//# sourceMappingURL=gateway-types.d.ts.map

package/dist/types/channels/gateway-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gateway-types.d.ts","sourceRoot":"","sources":["../../../src/channels/gateway-types.ts"],"names":[],"mappings":"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"}

package/dist/types/types/channel-account-protocol.d.ts

@@ -1,14 +0,0 @@
-export type DmPolicy = "pairing" | "allowlist" | "open";
-export type ChannelReplyMode = "tool" | "relay";
-export type ChannelPluginConfig = Record<string, unknown>;
-export interface ChannelAccountCreatePayload {
-    account_id?: string;
-    display_name?: string;
-    enabled?: boolean;
-    dm_policy?: DmPolicy;
-    reply_mode?: ChannelReplyMode;
-    allowed_users?: string[];
-    /** Plugin-owned account config. New fields should be added here, not centrally. */
-    config?: ChannelPluginConfig;
-}
-//# sourceMappingURL=channel-account-protocol.d.ts.map

package/dist/types/types/channel-account-protocol.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"channel-account-protocol.d.ts","sourceRoot":"","sources":["../../../src/types/channel-account-protocol.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AACxD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC;AAChD,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1D,MAAM,WAAW,2BAA2B;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,mFAAmF;IACnF,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B"}