@maudecode/talaria-web-contracts 1.15.0 → 1.16.1

package/dist/routes/workspaces.d.ts

@@ -3,7 +3,7 @@ export declare const workspacesContract: {
     workspaces: {
         list: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, z.ZodObject<{
             workspaces: z.ZodArray<z.ZodObject<{
-                name: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
                 path: z.ZodString;
             }, z.core.$loose>>;
             last: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -22,7 +22,7 @@ export declare const workspacesContract: {
         }, z.core.$strip>, z.ZodObject<{
             ok: z.ZodLiteral<true>;
             workspaces: z.ZodArray<z.ZodObject<{
-                name: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
                 path: z.ZodString;
             }, z.core.$loose>>;
         }, z.core.$strip>, Record<never, never>, Record<never, never>>;
@@ -31,7 +31,7 @@ export declare const workspacesContract: {
         }, z.core.$strip>, z.ZodObject<{
             ok: z.ZodLiteral<true>;
             workspaces: z.ZodArray<z.ZodObject<{
-                name: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
                 path: z.ZodString;
             }, z.core.$loose>>;
         }, z.core.$strip>, Record<never, never>, Record<never, never>>;
@@ -41,7 +41,7 @@ export declare const workspacesContract: {
         }, z.core.$strip>, z.ZodObject<{
             ok: z.ZodLiteral<true>;
             workspaces: z.ZodArray<z.ZodObject<{
-                name: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
                 path: z.ZodString;
             }, z.core.$loose>>;
         }, z.core.$strip>, Record<never, never>, Record<never, never>>;
@@ -50,7 +50,7 @@ export declare const workspacesContract: {
         }, z.core.$strip>, z.ZodObject<{
             ok: z.ZodLiteral<true>;
             workspaces: z.ZodArray<z.ZodObject<{
-                name: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
                 path: z.ZodString;
             }, z.core.$loose>>;
         }, z.core.$strip>, Record<never, never>, Record<never, never>>;

package/dist/sidecar/methods.d.ts

@@ -35,7 +35,9 @@ export declare const SIDECAR_METHODS: {
             messages: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             final_response: z.ZodString;
             error: z.ZodNullable<z.ZodString>;
-            result_status: z.ZodString;
+            failed: z.ZodBoolean;
+            partial: z.ZodBoolean;
+            compression_exhausted: z.ZodBoolean;
             tool_limit_reached: z.ZodBoolean;
             usage: z.ZodObject<{
                 prompt_tokens: z.ZodNumber;
@@ -102,6 +104,13 @@ export declare const SIDECAR_METHODS: {
         }, z.core.$strip>, z.ZodObject<{
             event: z.ZodLiteral<"clarify_resolved">;
             data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>, z.ZodObject<{
+            event: z.ZodLiteral<"approval_resolved">;
+            data: z.ZodObject<{
+                approval_id: z.ZodString;
+                session_id: z.ZodOptional<z.ZodString>;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>;
         }, z.core.$strip>, z.ZodObject<{
             event: z.ZodLiteral<"compressing">;
             data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -209,6 +218,7 @@ export declare const SIDECAR_METHODS: {
     readonly 'chat.evict_agent': {
         readonly params: z.ZodObject<{
             session_id: z.ZodString;
+            clear_session: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>;
         readonly result: z.ZodObject<{
             evicted: z.ZodBoolean;
@@ -491,15 +501,6 @@ export declare const SIDECAR_METHODS: {
             text: z.ZodString;
         }, z.core.$strip>;
     };
-    readonly 'text.redact': {
-        readonly params: z.ZodObject<{
-            text: z.ZodString;
-            force: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strip>;
-        readonly result: z.ZodObject<{
-            text: z.ZodString;
-        }, z.core.$strip>;
-    };
     readonly 'text.image_mode': {
         readonly params: z.ZodObject<{
             profile_home: z.ZodString;
@@ -565,6 +566,59 @@ export declare const SIDECAR_METHODS: {
             error: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
     };
+    readonly 'oauth.start': {
+        readonly params: z.ZodObject<{
+            profile_home: z.ZodString;
+            provider: z.ZodString;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            flow_id: z.ZodString;
+            provider: z.ZodString;
+            status: z.ZodLiteral<"pending">;
+            user_code: z.ZodString;
+            verification_url: z.ZodString;
+            expires_in: z.ZodNumber;
+            interval: z.ZodNumber;
+        }, z.core.$strip>;
+    };
+    readonly 'oauth.poll': {
+        readonly params: z.ZodObject<{
+            profile_home: z.ZodString;
+            flow_id: z.ZodString;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            flow_id: z.ZodString;
+            provider: z.ZodString;
+            status: z.ZodEnum<{
+                error: "error";
+                cancelled: "cancelled";
+                pending: "pending";
+                approved: "approved";
+                denied: "denied";
+                expired: "expired";
+            }>;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    readonly 'oauth.cancel': {
+        readonly params: z.ZodObject<{
+            profile_home: z.ZodString;
+            flow_id: z.ZodString;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            flow_id: z.ZodString;
+            provider: z.ZodString;
+            status: z.ZodEnum<{
+                error: "error";
+                cancelled: "cancelled";
+                pending: "pending";
+                approved: "approved";
+                denied: "denied";
+                expired: "expired";
+            }>;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    };
     readonly 'providers.registry': {
         readonly params: z.ZodObject<{
             profile_home: z.ZodString;
@@ -1467,8 +1521,14 @@ export declare const SIDECAR_METHODS: {
             providers: z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 display_name: z.ZodString;
-                env_vars: z.ZodArray<z.ZodString>;
-                api_key_env: z.ZodNullable<z.ZodString>;
+                auth_type: z.ZodString;
+                setup: z.ZodEnum<{
+                    ready: "ready";
+                    missing_cli: "missing_cli";
+                    needs_setup: "needs_setup";
+                    not_loaded: "not_loaded";
+                    unavailable: "unavailable";
+                }>;
             }, z.core.$strip>>;
         }, z.core.$strip>;
     };

package/dist/sidecar/methods.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { AUX_METHODS, COMMANDS_METHODS, CRON_METHODS, GATEWAY_METHODS, GOALS_METHODS, KANBAN_METHODS, MCP_METHODS, PROCESS_METHODS, PROFILES_METHODS, PROVIDERS_METHODS, SKILLS_METHODS, STATE_DB_METHODS, STT_METHODS, TEXT_METHODS, USAGE_METHODS, WORKTREE_METHODS, CHAT_METHODS, CONFIG_METHODS, } from './namespaces.js';
+import { AUX_METHODS, COMMANDS_METHODS, CRON_METHODS, GATEWAY_METHODS, GOALS_METHODS, KANBAN_METHODS, MCP_METHODS, PROCESS_METHODS, PROFILES_METHODS, PROVIDERS_METHODS, SKILLS_METHODS, STATE_DB_METHODS, STT_METHODS, OAUTH_METHODS, TEXT_METHODS, USAGE_METHODS, WORKTREE_METHODS, CHAT_METHODS, CONFIG_METHODS, } from './namespaces.js';
 import { OkResultSchema, RpcCancelParamsSchema, RpcCancelResultSchema, RpcMethodsResultSchema, RuntimeDescribeSchema, RuntimeEnsureCurrentResultSchema, RuntimeEnvParamsSchema, RuntimeHandshakeParamsSchema, RuntimeShutdownParamsSchema, } from './runtime.js';
 const Empty = z.object({});
 /**
@@ -25,6 +25,7 @@ export const SIDECAR_METHODS = {
     ...STT_METHODS,
     ...CRON_METHODS,
     ...PROVIDERS_METHODS,
+    ...OAUTH_METHODS,
     ...AUX_METHODS,
     ...TEXT_METHODS,
     ...PROCESS_METHODS,

package/dist/sidecar/methods.js.map

@@ -1 +1 @@
-{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../src/sidecar/methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EACL,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAC3I,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,GAC9I,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,cAAc,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,qBAAqB,EAC3G,gCAAgC,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,2BAA2B,GACpH,MAAM,cAAc,CAAA;AAErB,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AAE1B;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY,EAAE,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,qBAAqB,EAAE;IAC9E,aAAa,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE;IAChE,mBAAmB,EAAE,EAAE,MAAM,EAAE,4BAA4B,EAAE,MAAM,EAAE,qBAAqB,EAAE;IAC5F,gBAAgB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE;IAClE,wBAAwB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,gCAAgC,EAAE;IACrF,kBAAkB,EAAE,EAAE,MAAM,EAAE,2BAA2B,EAAE,MAAM,EAAE,cAAc,EAAE;IACnF,aAAa,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,cAAc,EAAE;IACzE,GAAG,aAAa;IAChB,GAAG,gBAAgB;IACnB,GAAG,cAAc;IACjB,GAAG,gBAAgB;IACnB,GAAG,gBAAgB;IACnB,GAAG,cAAc;IACjB,GAAG,WAAW;IACd,GAAG,WAAW;IACd,GAAG,YAAY;IACf,GAAG,iBAAiB;IACpB,GAAG,WAAW;IACd,GAAG,YAAY;IACf,GAAG,eAAe;IAClB,GAAG,aAAa;IAChB,GAAG,eAAe;IAClB,GAAG,gBAAgB;IACnB,GAAG,cAAc;IACjB,GAAG,YAAY;CACP,CAAA;AAQV,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAwB,CAAA"}
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../src/sidecar/methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EACL,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAC3I,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,GAC7J,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,cAAc,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,qBAAqB,EAC3G,gCAAgC,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,2BAA2B,GACpH,MAAM,cAAc,CAAA;AAErB,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AAE1B;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY,EAAE,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,qBAAqB,EAAE;IAC9E,aAAa,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE;IAChE,mBAAmB,EAAE,EAAE,MAAM,EAAE,4BAA4B,EAAE,MAAM,EAAE,qBAAqB,EAAE;IAC5F,gBAAgB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE;IAClE,wBAAwB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,gCAAgC,EAAE;IACrF,kBAAkB,EAAE,EAAE,MAAM,EAAE,2BAA2B,EAAE,MAAM,EAAE,cAAc,EAAE;IACnF,aAAa,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,cAAc,EAAE;IACzE,GAAG,aAAa;IAChB,GAAG,gBAAgB;IACnB,GAAG,cAAc;IACjB,GAAG,gBAAgB;IACnB,GAAG,gBAAgB;IACnB,GAAG,cAAc;IACjB,GAAG,WAAW;IACd,GAAG,WAAW;IACd,GAAG,YAAY;IACf,GAAG,iBAAiB;IACpB,GAAG,aAAa;IAChB,GAAG,WAAW;IACd,GAAG,YAAY;IACf,GAAG,eAAe;IAClB,GAAG,aAAa;IAChB,GAAG,eAAe;IAClB,GAAG,gBAAgB;IACnB,GAAG,cAAc;IACjB,GAAG,YAAY;CACP,CAAA;AAQV,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAwB,CAAA"}

package/dist/sidecar/namespaces.d.ts

@@ -176,11 +176,22 @@ export declare const CommandSchema: z.ZodObject<{
     cli_only: z.ZodBoolean;
     gateway_only: z.ZodBoolean;
 }, z.core.$strip>;
+/**
+ * A model-provider plugin installed and enabled in the profile (TAL-288); bundled providers are built-ins. `setup` is the Agent's
+ * own verdict without spawning the plugin's CLI: `not_loaded` means the installed plugin could not be loaded (import failure, or its
+ * provider id or directory name is taken by another profile's plugin in this process-wide registry).
+ */
 export declare const PluginProviderSchema: z.ZodObject<{
     name: z.ZodString;
     display_name: z.ZodString;
-    env_vars: z.ZodArray<z.ZodString>;
-    api_key_env: z.ZodNullable<z.ZodString>;
+    auth_type: z.ZodString;
+    setup: z.ZodEnum<{
+        ready: "ready";
+        missing_cli: "missing_cli";
+        needs_setup: "needs_setup";
+        not_loaded: "not_loaded";
+        unavailable: "unavailable";
+    }>;
 }, z.core.$strip>;
 export declare const COMMANDS_METHODS: {
     readonly 'commands.registry': {
@@ -230,8 +241,14 @@ export declare const COMMANDS_METHODS: {
             providers: z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 display_name: z.ZodString;
-                env_vars: z.ZodArray<z.ZodString>;
-                api_key_env: z.ZodNullable<z.ZodString>;
+                auth_type: z.ZodString;
+                setup: z.ZodEnum<{
+                    ready: "ready";
+                    missing_cli: "missing_cli";
+                    needs_setup: "needs_setup";
+                    not_loaded: "not_loaded";
+                    unavailable: "unavailable";
+                }>;
             }, z.core.$strip>>;
         }, z.core.$strip>;
     };
@@ -1232,6 +1249,75 @@ export declare const PROVIDERS_METHODS: {
         }, z.core.$strip>;
     };
 };
+/**
+ * TAL-398: an Agent device-code sign-in (Nous Portal, OpenAI Codex, xAI, MiniMax) the sidecar runs for one profile home.
+ * `oauth.start` answers the code to show; a sidecar thread polls the provider and writes the credential through the
+ * Agent's own auth store. A flow belongs to the profile home that started it: poll and cancel from another home do not
+ * find it. `error` is the Agent's reason for a flow that ended without a credential.
+ */
+export declare const OAuthFlowStatusSchema: z.ZodEnum<{
+    error: "error";
+    cancelled: "cancelled";
+    pending: "pending";
+    approved: "approved";
+    denied: "denied";
+    expired: "expired";
+}>;
+export declare const OAUTH_METHODS: {
+    readonly 'oauth.start': {
+        readonly params: z.ZodObject<{
+            profile_home: z.ZodString;
+            provider: z.ZodString;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            flow_id: z.ZodString;
+            provider: z.ZodString;
+            status: z.ZodLiteral<"pending">;
+            user_code: z.ZodString;
+            verification_url: z.ZodString;
+            expires_in: z.ZodNumber;
+            interval: z.ZodNumber;
+        }, z.core.$strip>;
+    };
+    readonly 'oauth.poll': {
+        readonly params: z.ZodObject<{
+            profile_home: z.ZodString;
+            flow_id: z.ZodString;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            flow_id: z.ZodString;
+            provider: z.ZodString;
+            status: z.ZodEnum<{
+                error: "error";
+                cancelled: "cancelled";
+                pending: "pending";
+                approved: "approved";
+                denied: "denied";
+                expired: "expired";
+            }>;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    readonly 'oauth.cancel': {
+        readonly params: z.ZodObject<{
+            profile_home: z.ZodString;
+            flow_id: z.ZodString;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            flow_id: z.ZodString;
+            provider: z.ZodString;
+            status: z.ZodEnum<{
+                error: "error";
+                cancelled: "cancelled";
+                pending: "pending";
+                approved: "approved";
+                denied: "denied";
+                expired: "expired";
+            }>;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    };
+};
 export declare const AuxUsageSchema: z.ZodObject<{
     prompt_tokens: z.ZodOptional<z.ZodNumber>;
     completion_tokens: z.ZodOptional<z.ZodNumber>;
@@ -1278,15 +1364,6 @@ export declare const AUX_METHODS: {
     };
 };
 export declare const TEXT_METHODS: {
-    readonly 'text.redact': {
-        readonly params: z.ZodObject<{
-            text: z.ZodString;
-            force: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strip>;
-        readonly result: z.ZodObject<{
-            text: z.ZodString;
-        }, z.core.$strip>;
-    };
     readonly 'text.image_mode': {
         readonly params: z.ZodObject<{
             profile_home: z.ZodString;
@@ -1541,6 +1618,7 @@ export declare const ChatUsageSchema: z.ZodObject<{
     cache_write_tokens: z.ZodNumber;
     estimated_cost_usd: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
+/** `failed`, `partial`, and `compression_exhausted` are the Agent's own turn-result flags, forwarded as sent; `failed` also sets `status: 'error'`. */
 export declare const ChatStartResultSchema: z.ZodObject<{
     status: z.ZodEnum<{
         error: "error";
@@ -1550,7 +1628,9 @@ export declare const ChatStartResultSchema: z.ZodObject<{
     messages: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     final_response: z.ZodString;
     error: z.ZodNullable<z.ZodString>;
-    result_status: z.ZodString;
+    failed: z.ZodBoolean;
+    partial: z.ZodBoolean;
+    compression_exhausted: z.ZodBoolean;
     tool_limit_reached: z.ZodBoolean;
     usage: z.ZodObject<{
         prompt_tokens: z.ZodNumber;
@@ -1617,6 +1697,13 @@ export declare const ChatStreamSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     event: z.ZodLiteral<"clarify_resolved">;
     data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    event: z.ZodLiteral<"approval_resolved">;
+    data: z.ZodObject<{
+        approval_id: z.ZodString;
+        session_id: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
 }, z.core.$strip>, z.ZodObject<{
     event: z.ZodLiteral<"compressing">;
     data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -1658,7 +1745,9 @@ export declare const CHAT_METHODS: {
             messages: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             final_response: z.ZodString;
             error: z.ZodNullable<z.ZodString>;
-            result_status: z.ZodString;
+            failed: z.ZodBoolean;
+            partial: z.ZodBoolean;
+            compression_exhausted: z.ZodBoolean;
             tool_limit_reached: z.ZodBoolean;
             usage: z.ZodObject<{
                 prompt_tokens: z.ZodNumber;
@@ -1725,6 +1814,13 @@ export declare const CHAT_METHODS: {
         }, z.core.$strip>, z.ZodObject<{
             event: z.ZodLiteral<"clarify_resolved">;
             data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>, z.ZodObject<{
+            event: z.ZodLiteral<"approval_resolved">;
+            data: z.ZodObject<{
+                approval_id: z.ZodString;
+                session_id: z.ZodOptional<z.ZodString>;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>;
         }, z.core.$strip>, z.ZodObject<{
             event: z.ZodLiteral<"compressing">;
             data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -1850,6 +1946,7 @@ export declare const CHAT_METHODS: {
     readonly 'chat.evict_agent': {
         readonly params: z.ZodObject<{
             session_id: z.ZodString;
+            clear_session: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>;
         readonly result: z.ZodObject<{
             evicted: z.ZodBoolean;

package/dist/sidecar/namespaces.js

@@ -32,7 +32,12 @@ export const CommandSchema = z.object({
     name: z.string(), description: z.string(), category: z.string(), aliases: z.array(z.string()), args_hint: z.string(), subcommands: z.array(z.string()),
     cli_only: z.boolean(), gateway_only: z.boolean(),
 });
-export const PluginProviderSchema = z.object({ name: z.string(), display_name: z.string(), env_vars: z.array(z.string()), api_key_env: z.string().nullable() });
+/**
+ * A model-provider plugin installed and enabled in the profile (TAL-288); bundled providers are built-ins. `setup` is the Agent's
+ * own verdict without spawning the plugin's CLI: `not_loaded` means the installed plugin could not be loaded (import failure, or its
+ * provider id or directory name is taken by another profile's plugin in this process-wide registry).
+ */
+export const PluginProviderSchema = z.object({ name: z.string(), display_name: z.string(), auth_type: z.string(), setup: z.enum(['ready', 'missing_cli', 'needs_setup', 'not_loaded', 'unavailable']) });
 export const COMMANDS_METHODS = {
     'commands.registry': { params: ProfileHomeParams, result: z.object({ commands: z.array(CommandSchema) }) },
     'commands.exec': { params: ProfileHomeParams.extend({ command: z.string().min(1) }), result: z.object({ output: z.string(), source: z.enum(['agent', 'plugin']) }) },
@@ -155,6 +160,21 @@ export const PROVIDERS_METHODS = {
     'models.estimate_tokens': { params: z.object({ messages: z.array(Loose) }), result: z.object({ tokens: z.number().int() }) },
     'models.capabilities': { params: ProfileHomeParams.extend({ provider: z.string(), model: z.string() }), result: z.object({ capabilities: Loose.nullable() }) },
 };
+// ── oauth ──────────────────────────────────────────────────────────────
+/**
+ * TAL-398: an Agent device-code sign-in (Nous Portal, OpenAI Codex, xAI, MiniMax) the sidecar runs for one profile home.
+ * `oauth.start` answers the code to show; a sidecar thread polls the provider and writes the credential through the
+ * Agent's own auth store. A flow belongs to the profile home that started it: poll and cancel from another home do not
+ * find it. `error` is the Agent's reason for a flow that ended without a credential.
+ */
+export const OAuthFlowStatusSchema = z.enum(['pending', 'approved', 'denied', 'expired', 'cancelled', 'error']);
+const OAuthFlow = z.object({ flow_id: z.string(), provider: z.string(), status: OAuthFlowStatusSchema, error: z.string().nullable() });
+const OAuthFlowParams = ProfileHomeParams.extend({ flow_id: z.string().min(1) });
+export const OAUTH_METHODS = {
+    'oauth.start': { params: ProfileHomeParams.extend({ provider: z.string().min(1) }), result: z.object({ flow_id: z.string(), provider: z.string(), status: z.literal('pending'), user_code: z.string(), verification_url: z.string(), expires_in: z.number().int(), interval: z.number().int() }) },
+    'oauth.poll': { params: OAuthFlowParams, result: OAuthFlow },
+    'oauth.cancel': { params: OAuthFlowParams, result: OAuthFlow },
+};
 // ── aux / text / process / usage / gateway ─────────────────────────────
 export const AuxUsageSchema = z.object({ prompt_tokens: z.number().int().optional(), completion_tokens: z.number().int().optional(), total_tokens: z.number().int().optional() });
 export const AUX_METHODS = {
@@ -162,7 +182,6 @@ export const AUX_METHODS = {
     'aux.resolve': { params: ProfileHomeParams.extend({ task: z.string().min(1), main_runtime: Loose.nullable().optional() }), result: z.object({ configured: z.boolean(), model: z.string().nullable(), error: z.string().optional() }) },
 };
 export const TEXT_METHODS = {
-    'text.redact': { params: z.object({ text: z.string(), force: z.boolean().optional() }), result: z.object({ text: z.string() }) },
     'text.image_mode': { params: ProfileHomeParams.extend({ provider: z.string(), model: z.string(), cfg: Loose.nullable().optional(), requested_provider: z.string().optional() }), result: z.object({ mode: z.enum(['native', 'text']), reason: z.string(), supports_vision: z.boolean().nullable() }) },
     'text.portal_tags': { params: ProfileHomeParams, result: z.object({ client_tag: z.string().nullable(), conversation_tag: z.string().nullable(), tags: z.union([z.array(z.string()), Loose]) }) },
 };
@@ -212,8 +231,10 @@ export const WORKTREE_METHODS = {
 };
 // ── chat / approval / clarify ──────────────────────────────────────────
 export const ChatUsageSchema = z.object({ prompt_tokens: z.number().int(), completion_tokens: z.number().int(), cache_read_tokens: z.number().int(), cache_write_tokens: z.number().int(), estimated_cost_usd: z.number().nullable() });
+/** `failed`, `partial`, and `compression_exhausted` are the Agent's own turn-result flags, forwarded as sent; `failed` also sets `status: 'error'`. */
 export const ChatStartResultSchema = z.object({
-    status: z.enum(['completed', 'cancelled', 'error']), messages: z.array(Loose), final_response: z.string(), error: z.string().nullable(), result_status: z.string(),
+    status: z.enum(['completed', 'cancelled', 'error']), messages: z.array(Loose), final_response: z.string(), error: z.string().nullable(),
+    failed: z.boolean(), partial: z.boolean(), compression_exhausted: z.boolean(),
     tool_limit_reached: z.boolean(), usage: ChatUsageSchema, context: Loose, model: z.string(), provider: z.string(), compressed: z.boolean(), agent_session_id: z.string(),
     token_sent: z.boolean(), pending_steer: z.string(), live_tool_calls: z.array(Loose),
 });
@@ -234,6 +255,8 @@ export const ChatStreamSchema = z.discriminatedUnion('event', [
     z.object({ event: z.literal('approval'), data: Loose }),
     z.object({ event: z.literal('clarify'), data: Loose }),
     z.object({ event: z.literal('clarify_resolved'), data: Loose }),
+    /** The Agent stopped waiting on an approval: `reason` is its settle cause (`resolved`, `timeout`, `interrupted`, `session_closed`). */
+    z.object({ event: z.literal('approval_resolved'), data: z.looseObject({ approval_id: z.string(), session_id: z.string().optional(), reason: z.string().optional() }) }),
     z.object({ event: z.literal('compressing'), data: Loose }),
     z.object({ event: z.literal('warning'), data: Loose }),
     z.object({ event: z.literal('status'), data: Loose }),
@@ -291,7 +314,7 @@ export const CHAT_METHODS = {
     },
     /** TAL-255: second phase of `chat.compress`; `finalized: false` when the token is unknown or already expired. */
     'chat.compress_finalize': { params: z.object({ commit_token: z.string().min(1), committed: z.boolean() }), result: z.object({ finalized: z.boolean() }) },
-    'chat.evict_agent': { params: z.object({ session_id: z.string().min(1) }), result: z.object({ evicted: z.boolean() }) },
+    'chat.evict_agent': { params: z.object({ session_id: z.string().min(1), clear_session: z.boolean().optional() }), result: z.object({ evicted: z.boolean() }) },
     'chat.commit_memory': { params: z.object({ session_id: z.string().min(1) }), result: z.object({ committed: z.boolean() }) },
     'approval.respond': { params: ProfileHomeParams.extend({ session_id: z.string().min(1), choice: z.enum(['once', 'session', 'always', 'deny']), request_id: z.string().nullable().optional() }), result: z.object({ ok: z.boolean(), resolved: z.number().int(), choice: z.string() }) },
     'approval.pending': { params: z.object({ session_id: z.string().min(1) }), result: z.object({ pending: z.array(Loose) }) },