@maudecode/talaria-web-contracts 1.20.0 → 1.22.0

package/dist/sidecar/namespaces.js

@@ -1,5 +1,11 @@
+import { DelegationRegistrySchema, DelegationBlockSchema } from '../delegation.js';
+import { GroupSidecarParamsSchema, GroupSidecarResultSchema } from '../groups-native.js';
+import { PlanGaugeSchema, ModelAllowanceSnapshotSchema } from '../plan-usage.js';
+import { OutboundDraftRefSchema, OutboundDraftFieldsSchema, OutboundDraftResultSchema } from '../outbound-drafts.js';
+import { McpCostPolicyDataSchema } from '../mcp-cost-policy.js';
 import { ContextDetailSchema } from '../context-detail.js';
 import { z } from 'zod';
+import { AgentImportSourceSchema, AgentImportResultSchema } from '../agent-imports.js';
 import { ProviderPhaseSchema } from '../run-status.js';
 import { SpeedTierSchema } from '../speed.js';
 import { GatewayClarifyBatchSchema, GatewayCreateParamsSchema, GatewaySessionParamsSchema, GatewaySessionResultSchema } from '../gateway-session.js';
@@ -105,7 +111,11 @@ const DashboardNameParams = ProfileHomeParams.extend({ name: z.string() });
 export const CommandBundleSchema = z.object({ name: z.string(), description: z.string(), skill_count: z.number().int(), source: z.literal('bundle') });
 /** `message` is the user message that loads the bundle's skills; members not installed or disabled are in `missing_skills` or left out. */
 export const CommandBundleInvocationSchema = z.object({ name: z.string(), source: z.literal('bundle'), message: z.string(), loaded_skills: z.array(z.string()), missing_skills: z.array(z.string()) });
+export const MAX_MANAGED_BUFFER_BYTES = 256 * 1024;
+const ManagedBufferName = z.string().regex(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/);
+const ManagedBufferSize = z.number().int().min(0).max(MAX_MANAGED_BUFFER_BYTES);
 export const COMMANDS_METHODS = {
+    'drafts.review': { params: OutboundDraftRefSchema.extend({ profile_home: z.string().min(1), session_id: z.string().min(1), action: z.enum(['read', 'edit', 'approve']), version: z.number().int().positive().optional(), revision: z.string().optional(), fields: OutboundDraftFieldsSchema.optional() }), result: OutboundDraftResultSchema },
     'commands.registry': { params: ProfileHomeParams, result: z.object({ commands: z.array(CommandSchema) }) },
     /**
      * With `session_id`, a plugin command runs under that chat's session binding and `workspace` (TAL-904) and receives the session
@@ -121,6 +131,11 @@ export const COMMANDS_METHODS = {
     'commands.bundles': { params: ProfileHomeParams, result: z.object({ bundles: z.array(CommandBundleSchema) }) },
     'commands.bundle_resolve': { params: ProfileHomeParams.extend({ command: z.string().min(1) }), result: CommandBundleInvocationSchema },
     'commands.moa_preset': { params: ProfileHomeParams.extend({ preset: z.string().nullable().optional() }), result: z.object({ moa: Loose }) },
+    /** Fixed devkit buffer adapter. No arbitrary HTTP paths, promotion or cleanup. Native saves are unconditional. */
+    'plugins.buffers': {
+        params: ProfileHomeParams.extend({ action: z.enum(['list', 'read', 'save']), session_id: z.string().min(1).max(200), name: ManagedBufferName.optional(), content: z.string().max(MAX_MANAGED_BUFFER_BYTES).optional() }),
+        result: z.object({ supported: z.boolean(), buffers: z.array(z.object({ name: ManagedBufferName, size: ManagedBufferSize, read_only: z.boolean() })).max(200), content: z.string().max(MAX_MANAGED_BUFFER_BYTES).optional(), size: ManagedBufferSize.optional(), read_only: z.boolean().optional(), write_semantics: z.literal('unconditional') }),
+    },
     'plugins.dashboard_list': { params: ProfileHomeParams, result: z.object({ supported: z.boolean(), plugins: z.array(AgentDashboardPluginSchema) }) },
     'plugins.dashboard_toggle': { params: DashboardNameParams.extend({ enabled: z.boolean() }), result: z.object({ ok: z.literal(true) }) },
     'plugins.dashboard_asset': { params: DashboardNameParams.extend({ path: z.string() }), result: AgentDashboardResponseSchema },
@@ -172,7 +187,14 @@ export const KanbanBoardSchema = z.union([
 export const KanbanAssigneeSchema = z.union([z.string(), z.object({ name: z.string(), on_disk: z.boolean().optional(), counts: z.record(z.string(), z.number().int()).optional() }).catchall(Json)]);
 export const KanbanEventSchema = z.object({ id: z.number().int(), task_id: z.string().nullable(), run_id: z.union([z.number().int(), z.string()]).nullable(), kind: z.string(), payload: Json, created_at: z.number().nullable() });
 export const KanbanBoardMetaSchema = z.object({ slug: z.string(), name: z.string().nullable().optional(), archived: z.boolean().optional() }).catchall(Json);
+export const KanbanInspectionEdgeSchema = z.object({ source: z.string(), target: z.string() });
+export const KanbanInspectionNodeSchema = z.object({ key: z.string(), board: z.string(), board_name: z.string(), task: KanbanTaskSchema.extend(KanbanRunStartShape) });
+export const KanbanInspectionSnapshotSchema = z.object({
+    nodes: z.array(KanbanInspectionNodeSchema).max(500),
+    edges: z.array(KanbanInspectionEdgeSchema).max(2000), generated_at: z.number(), truncated: z.boolean(), read_only: z.boolean(),
+});
 export const KANBAN_METHODS = {
+    'kanban.inspection': { params: Board.extend({ include_archived: z.boolean().optional() }), result: KanbanInspectionSnapshotSchema },
     'kanban.board': { params: Board.extend({ tenant: z.string().nullable().optional(), assignee: z.string().nullable().optional(), include_archived: z.boolean().optional(), only_mine: z.boolean().optional(), since: z.number().int().nullable().optional(), profile: z.string().nullable().optional() }), result: KanbanBoardSchema },
     'kanban.boards': { params: ProfileHomeParams.extend({ include_archived: z.boolean().optional() }), result: z.object({ boards: z.array(KanbanBoardMetaSchema.extend({ is_current: z.boolean(), counts: z.record(z.string(), z.number().int()), total: z.number().int() })), current: z.string(), read_only: z.boolean() }) },
     'kanban.create_board': { params: ProfileHomeParams.extend({ board_spec: Loose }), result: z.object({ board: KanbanBoardMetaSchema, current: z.string(), read_only: z.boolean() }) },
@@ -240,6 +262,7 @@ export const ProfileRowSchema = z.object({
     canonical_session: CanonicalBotChatSchema.nullable().default(null),
 });
 export const PROFILES_METHODS = {
+    'profiles.import': { params: ProfileHomeParams.extend({ action: z.enum(['discover', 'preview', 'apply', 'result']), agent: AgentImportSourceSchema.optional(), receipt: z.string().min(1).max(128).optional() }), result: AgentImportResultSchema },
     'profiles.list': { params: BaseHomeParams, result: z.object({ profiles: z.array(ProfileRowSchema) }) },
     'profiles.create': { params: BaseHomeParams.extend({ name: z.string().min(1), clone_from: z.string().nullable().optional(), clone_config: z.boolean().optional() }), result: z.object({ profile: ProfileRowSchema }) },
     'profiles.delete': { params: BaseHomeParams.extend({ name: z.string().min(1) }), result: z.object({ ok: z.literal(true) }) },
@@ -252,22 +275,43 @@ export const SkillCatalogIdentitySchema = z.object({
     status: z.enum(['unique', 'ambiguous', 'shadowed']).optional(), tier: z.number().int().optional(),
 });
 export const SkillRowSchema = SkillCatalogIdentitySchema.extend({ name: z.string(), description: z.string(), category: z.string().nullable(), disabled: z.boolean() });
+export const SkillRevisionIdSchema = z.string().regex(/^[a-f0-9]{64}$/);
+export const SkillRevisionsInputSchema = z.object({ name: z.string().min(1).max(256), revision: SkillRevisionIdSchema.optional(), compare_to: SkillRevisionIdSchema.optional() });
+/** Read-only, profile/skill-bound saved history. Raw content hashes never authorize a write or replay. */
+export const SkillRevisionsSchema = z.object({
+    state: z.enum(['available', 'missing', 'unavailable']),
+    reason: z.enum(['backend_unavailable', 'identity_unavailable', 'history_unavailable', 'invalid_history']).nullable(),
+    backend_revision: z.string().regex(/^[a-f0-9]{40}$/).nullable(),
+    revisions: z.array(z.object({ id: SkillRevisionIdSchema, sha256: SkillRevisionIdSchema, label: z.string().max(12), saved_at: z.string().nullable(), actor: z.string().max(80).nullable(), current: z.boolean() })).max(64),
+    selected: z.object({ revision: SkillRevisionIdSchema, content: z.string().max(32 * 1024) }).nullable(),
+    comparison: z.object({ from_revision: SkillRevisionIdSchema, to_revision: SkillRevisionIdSchema, diff: z.string().max(128 * 1024) }).nullable(),
+    replay_available: z.literal(false),
+});
 export const SkillViewSchema = z.union([
     z.object({ success: z.literal(true), name: z.string(), description: z.string(), tags: z.array(z.string()), related_skills: z.array(z.string()), content: z.string(), path: z.string(), skill_dir: z.string().nullable(), linked_files: z.record(z.string(), z.array(z.string())), editable: z.boolean().optional() }),
     z.object({ success: z.literal(false), error: z.string(), available_skills: z.array(z.string()).optional(), available_skills_truncated: z.boolean().optional(), total_skills: z.number().int().optional(), hint: z.string().optional() }),
 ]);
 export const SKILLS_METHODS = {
+    'skills.revisions': { params: SkillRevisionsInputSchema.extend({ profile_home: z.string().min(1) }), result: SkillRevisionsSchema },
     'skills.list': { params: ProfileHomeParams.extend({ category: z.string().nullable().optional() }), result: z.object({ success: z.boolean().optional(), skills: z.array(SkillRowSchema), categories: z.array(z.string()), count: z.number().int(), message: z.string().optional() }) },
     'skills.view': { params: ProfileHomeParams.extend({ name: z.string().min(1) }), result: SkillViewSchema },
     'skills.find': { params: ProfileHomeParams.extend({ name: z.string().min(1) }), result: z.object({ found: z.boolean(), skill_dir: z.string().nullable(), skill_md: z.string().nullable(), load_name: z.string().optional(), declared_name: z.string().optional(), sibling_load_names: z.array(z.string()).optional() }) },
 };
 // ── mcp ────────────────────────────────────────────────────────────────
 export const MCP_METHODS = {
+    'mcp.cost_policies': { params: ProfileHomeParams.extend({ servers: Loose }), result: z.object({ supported: z.boolean(), policies: z.array(McpCostPolicyDataSchema) }) },
     'mcp.status': { params: ProfileHomeParams, result: z.object({ servers: z.array(z.object({ name: z.string() }).catchall(Json)) }) },
     'mcp.registry_tools': { params: ProfileHomeParams, result: z.object({ tools: z.array(z.object({ name: z.string(), server: z.string(), schema: Loose })) }) },
     'mcp.reload': { params: ProfileHomeParams, result: z.object({ output: z.string() }) },
 };
 // ── connectors (TAL-818) ───────────────────────────────────────────────
+/** Safe current-account display. Authentication success is independent of native app handoff state. */
+export const NousAccountSchema = z.object({
+    account_id: z.string().min(1), email: z.string().nullable(),
+    state: z.enum(['idle', 'pending', 'retrying', 'claimed', 'gone', 'failed', 'paused', 'unknown', 'unavailable']),
+    lines: z.array(z.string()), moved: z.array(z.string()), dropped: z.array(z.string()), reconnect: z.array(z.string()),
+    poll_after: z.number().int().min(1).nullable(),
+});
 const ConnectorSlug = z.string().regex(/^[a-z0-9][a-z0-9_-]*$/);
 /** One portal policy layer's rules (the Agent's `PolicyBody`): `allow` names the apps that stay on, `deny` the ones off; `tools` turns single tools off. */
 export const ConnectorPolicyBodySchema = z.object({
@@ -290,7 +334,10 @@ const ConnectorOp = ProfileHomeParams.extend({ op_id: z.string().min(1) });
  * `connector_not_found`, `connection_not_found`, `policy_conflict` (the member rules changed since `expected_revision`), `policy_invalid`,
  * `operation_not_found`, `operation_settled`, `operation_refused`, `connectors_failed`.
  */
+const ConnectorOfferStatus = z.object({ available: z.boolean(), guest_id: z.string().nullable(), eligible: z.boolean(), due_in: z.number().int().nonnegative().nullable(), claimed: z.boolean() });
 export const CONNECTORS_METHODS = {
+    'connectors.offer.status': { params: ProfileHomeParams, result: ConnectorOfferStatus },
+    'connectors.offer.claim': { params: ProfileHomeParams.extend({ guest_id: z.string().min(1) }), result: ConnectorOfferStatus },
     /** The Agent's `connectors_available()`; never creates an identity. */
     'connectors.available': { params: ProfileHomeParams, result: z.object({ available: z.boolean() }) },
     'connectors.catalog': { params: ProfileHomeParams, result: z.object({ connectors: z.array(z.object({ slug: z.string(), name: z.string(), description: z.string(), category: z.string(), logo_url: z.string().nullable() })) }) },
@@ -301,10 +348,18 @@ export const CONNECTORS_METHODS = {
     /** One member-rule change: `enabled` turns the app on or off; `tool` with `tool_enabled` turns one of its tools on or off. */
     'connectors.policy.set': { params: ProfileHomeParams.extend({ connector: ConnectorSlug, expected_revision: z.string().min(1), enabled: z.boolean().optional(), tool: z.string().min(1).optional(), tool_enabled: z.boolean().optional() }), result: z.object({ revision: z.string() }) },
     /** Starts (or rejoins) the account-owned connect and waits for its authorization link. */
-    'connectors.connect': { params: ProfileHomeParams.extend({ connector: ConnectorSlug }), result: ConnectorOperationSnapshotSchema },
+    'connectors.connect': { params: ProfileHomeParams.extend({ connector: ConnectorSlug, nous_account_id: z.string().min(1).optional() }), result: ConnectorOperationSnapshotSchema },
     'connectors.operation': { params: ConnectorOp, result: ConnectorOperationSnapshotSchema },
     'connectors.respond': { params: ConnectorOp.extend({ action: z.enum(['skip', 'retry', 'approve', 'continue']), target: z.string().optional(), env: z.record(z.string(), z.string()).optional() }), result: ConnectorOperationSnapshotSchema },
 };
+// ── tts ────────────────────────────────────────────────────────────────
+/** The Agent owns speech providers, credentials and output encoding, as with STT. */
+export const TTS_METHODS = {
+    'tts.synthesize': {
+        params: ProfileHomeParams.extend({ text: z.string().min(1).max(5000), provider: z.string().min(1), speed: z.number().min(0.5).max(2).optional() }),
+        result: z.object({ provider: z.string(), format: z.string(), audio_b64: z.string() }),
+    },
+};
 // ── stt ────────────────────────────────────────────────────────────────
 export const STT_METHODS = {
     /**
@@ -376,8 +431,9 @@ export const CRON_METHODS = {
  */
 export const PROVIDERS_METHODS = {
     'providers.registry': { params: ProfileHomeParams, result: z.object({ providers: z.record(z.string(), z.object({ id: z.string(), name: z.string(), auth_type: z.string() }).catchall(Json)) }) },
+    'providers.nous_account': { params: ProfileHomeParams, result: z.object({ nous_account: NousAccountSchema.nullable() }) },
     'providers.auth_status': { params: ProfileHomeParams.extend({ provider: z.string().nullable().optional() }), result: z.object({ status: z.object({ logged_in: z.boolean() }).catchall(Json) }) },
-    'providers.model_ids': { params: ProfileHomeParams.extend({ provider: z.string().min(1), force_refresh: z.boolean().optional() }), result: z.object({ provider: z.string(), model_ids: z.array(z.string()), fallback: z.boolean().default(false) }) },
+    'providers.model_ids': { params: ProfileHomeParams.extend({ provider: z.string().min(1), force_refresh: z.boolean().optional() }), result: ModelAllowanceSnapshotSchema.extend({ provider: z.string(), model_ids: z.array(z.string()), fallback: z.boolean().default(false) }) },
     'providers.local_models': { params: ProfileHomeParams, result: z.object({ provider_id: z.string(), models: z.array(z.string()), current_endpoint: z.string().nullable() }) },
     'providers.resolve_runtime': { params: ProfileHomeParams.extend({ requested: z.string().nullable().optional(), api_key: z.string().nullable().optional(), base_url: z.string().nullable().optional(), target_model: z.string().nullable().optional() }), result: z.object({ runtime: Loose }) },
     'providers.credential_pool': { params: ProfileHomeParams.extend({ provider: z.string().min(1) }), result: z.object({ available: z.boolean(), strategy: z.string(), entries: z.array(Loose) }) },
@@ -401,7 +457,7 @@ export const PROVIDERS_METHODS = {
  * other address, `oauth_flow_ended` once the flow ended).
  */
 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 OAuthFlow = z.object({ flow_id: z.string(), provider: z.string(), status: OAuthFlowStatusSchema, error: z.string().nullable(), nous_account: NousAccountSchema.nullable().optional() });
 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().optional(), verification_url: z.string(), expires_in: z.number().int(), interval: z.number().int(), redirect_uri: z.string().optional(), authorize_host: z.string().optional(), token_host: z.string().optional() }) },
@@ -417,6 +473,9 @@ export const AUX_METHODS = {
      * of the task's auxiliary route; `credential_missing` means it has no credential. `finish_reason` is the provider's, when known.
      */
     'aux.complete': { params: ProfileHomeParams.extend({ task: z.string().min(1), messages: z.array(Loose).min(1), main_runtime: Loose.nullable().optional(), main_fallback: z.boolean().optional(), max_tokens: z.number().int().nullable().optional(), temperature: z.number().nullable().optional(), model: z.string().nullable().optional(), provider: z.string().nullable().optional() }), result: z.object({ model: z.string(), text: z.string(), usage: AuxUsageSchema.nullable(), finish_reason: z.string().nullable().default(null) }), stream: z.discriminatedUnion('event', [z.object({ event: z.literal('token'), data: z.object({ text: z.string() }) })]) },
+    'aux.delegation': { params: ProfileHomeParams.extend({ config: Loose }), result: DelegationRegistrySchema },
+    'aux.delegation_backend': { params: ProfileHomeParams.extend({ backend: z.string(), config_path: z.string() }), result: Ok },
+    'aux.delegation_routes': { params: ProfileHomeParams.extend({ backend: z.enum(['model_map', 'profile_routes']), block: DelegationBlockSchema, current: Loose }), result: z.object({ block: Loose }) },
     /**
      * TAL-800: the profile's auxiliary slots in Agent order (built-ins, then the profile's plugin tasks). `reasoning_effort`
      * is the slot's resolved effort (`''` = provider default); `effective` is the route an `inherit_from` task resolves to now.
@@ -576,7 +635,7 @@ export const CHECKPOINTS_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() });
+export const ChatUsageSchema = z.object({ plan_gauge: PlanGaugeSchema.nullable().optional(), 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'`.
  * `max_iterations_summary_request` is the Agent's text for the user row it appends to ask for a summary once its tool budget runs out
@@ -730,7 +789,7 @@ export const CHAT_METHODS = {
     '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) }) },
     'approval.set_yolo': { params: z.object({ session_id: z.string().min(1), enabled: z.boolean() }), result: z.object({ yolo_enabled: z.boolean(), released: z.number().int() }) },
-    'clarify.respond': { params: z.object({ stream_id: z.string().optional(), session_id: z.string().optional(), clarify_id: z.string().optional(), response: z.string() }), result: z.object({ ok: z.boolean(), clarify_id: z.string().optional() }) },
+    'clarify.respond': { params: z.object({ profile_home: z.string().optional(), stream_id: z.string().optional(), session_id: z.string().optional(), clarify_id: z.string().optional(), response: z.string() }), result: z.object({ ok: z.boolean(), clarify_id: z.string().optional() }) },
 };
 const GatewayActionParams = ProfileHomeParams.extend({ interrupt: z.boolean().optional(), cli_profile: z.string().nullable().optional(), quick_timeout_seconds: z.number().optional(), background_wait_seconds: z.number().optional() });
 /**
@@ -745,7 +804,7 @@ const GatewayActionStream = z.discriminatedUnion('event', [z.object({ event: z.l
 export const GATEWAY_ACTIONS = ['start', 'stop', 'restart'];
 export const GATEWAY_METHODS = {
     'gateway.session': { params: GatewaySessionParamsSchema, result: GatewaySessionResultSchema, stream: z.discriminatedUnion('event', [
-            z.object({ event: z.literal('snapshot'), data: GatewaySessionResultSchema.extend({ replaying: z.boolean().optional() }) }),
+            z.object({ event: z.literal('snapshot'), data: GatewaySessionResultSchema.extend({ replaying: z.boolean().optional(), reaction_only: z.boolean().optional() }) }),
             z.object({ event: z.literal('event'), data: Loose }),
             z.object({ event: z.literal('replay_complete'), data: z.object({}) }),
             z.object({ event: z.literal('clarify_batch'), data: GatewayClarifyBatchSchema }),
@@ -757,4 +816,5 @@ export const GATEWAY_METHODS = {
     /** TAL-805: the gateway mode of the profile `name` at `profile_home`; the root profile (`is_default`) is the host itself. */
     'gateway.mode': { params: ProfileHomeParams.extend({ name: z.string().min(1), is_default: z.boolean() }), result: z.object({ gateway_mode: GatewayModeSchema }) },
 };
+export const GROUP_METHODS = { 'gateway.groups': { params: GroupSidecarParamsSchema, result: GroupSidecarResultSchema } };
 //# sourceMappingURL=namespaces.js.map