@agentshouse/kit-wire 0.1.0-caf9c7b612dda → 0.1.0-cc189684f4a10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -9,11 +9,18 @@ The Kit wire: every shape agents.house and the Kit exchange, declared once with
9
9
  - Every `/kit/<act>` request and answer (`KIT_ACTS`), the names of the door acts the Kit calls
10
10
  at `/kit/door/<act>` (`KIT_DOOR_ACTS`), and the sign-in at `/kit` and `/kit/token`
11
11
  (`KIT_LOGIN_START`, `KIT_LOGIN_POLL` and their answers).
12
+ - The request-metadata key a `house` call names its Environment function run under
13
+ (`FUNCTION_RUN_META_KEY`).
12
14
  - `KIT_WIRE` is computed from those shapes, so a change to any of them is a new wire. A Kit
13
15
  names it in the `x-house-kit-wire` header (`KIT_WIRE_HEADER`) of every request and in its
14
16
  connection's subprotocol, `KIT_CONNECTION_PROTOCOL_PREFIX` followed by the wire. House serves
15
17
  its own wire alone and answers any other with `kit_update_required`, whose `release` and
16
18
  `commands` (`BUILDING_KIT`) name the Kit release its Building serves.
19
+ - At `@agentshouse/kit-wire/arguments`, the arguments House takes for each door act
20
+ (`KIT_DOOR_ARGUMENTS`) and for each Tool the Kit calls itself over a conversation's House
21
+ connection (`KIT_TOOLS`, `KIT_TOOL_ARGUMENTS`), each a zod schema of the JSON Schema of the
22
+ shape House refuses a call with, so a rule House checks in its own code stays out. They are
23
+ no part of the wire: a changed argument is a new version of this package, not a new wire.
17
24
 
18
25
  ```ts
19
26
  import { KIT_WIRE, KIT_WIRE_HEADER, KIT_CALL, type KitActRequest } from '@agentshouse/kit-wire';
package/dist/acts.d.ts CHANGED
@@ -366,7 +366,11 @@ export declare const KIT_ACTS: {
366
366
  }, z.core.$strict>>;
367
367
  }, z.core.$strict>;
368
368
  }, z.core.$strict>>;
369
+ 'function-runs/credentials/issue': KitActDeclaration<"run", z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
370
+ credential: z.ZodString;
371
+ }, z.core.$strict>>;
369
372
  };
373
+ export declare const FUNCTION_RUN_META_KEY = "agents.house/function-run";
370
374
  export type KitActName = keyof typeof KIT_ACTS;
371
375
  type Declared<Name extends KitActName> = (typeof KIT_ACTS)[Name];
372
376
  type Fields<Body> = Body extends unknown ? (string extends keyof Body ? {} : Body) : never;
package/dist/acts.js CHANGED
@@ -197,7 +197,9 @@ export const KIT_ACTS = {
197
197
  'conversations/credentials/issue': act(['conversation'], NOTHING, z.strictObject({ credential: z.string().min(1) })),
198
198
  'kits/log-out': act([], NOTHING, z.strictObject({ environment: z.uuid(), revoked: z.literal(true) })),
199
199
  'local-copies/selection/read': act([], NOTHING, z.strictObject({ local_copy: z.strictObject({ rooms: z.array(LOCAL_COPY_ROOM) }) })),
200
+ 'function-runs/credentials/issue': act(['run'], NOTHING, z.strictObject({ credential: z.string().min(1) })),
200
201
  };
202
+ export const FUNCTION_RUN_META_KEY = 'agents.house/function-run';
201
203
  export const KIT_DOOR_ACTS = [
202
204
  'rooms/discover',
203
205
  'room-chunks/list',
@@ -0,0 +1,11 @@
1
+ import { z } from 'zod';
2
+ import type { KitDoorAct } from './acts.ts';
3
+ export declare const KIT_TOOLS: readonly ['upload', 'update', 'info'];
4
+ export type KitTool = (typeof KIT_TOOLS)[number];
5
+ export type KitArgumentShape = Readonly<Record<string, unknown>>;
6
+ export interface KitArgumentShapes {
7
+ readonly door: Readonly<Record<KitDoorAct, KitArgumentShape>>;
8
+ readonly tools: Readonly<Record<KitTool, KitArgumentShape>>;
9
+ }
10
+ export declare const KIT_DOOR_ARGUMENTS: Readonly<Partial<Record<"changes/enumerate" | "files/revisions/list" | "room-chunks/list" | "rooms/discover" | "update", z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>>;
11
+ export declare const KIT_TOOL_ARGUMENTS: Readonly<Partial<Record<"info" | "update" | "upload", z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>>;
@@ -0,0 +1,11 @@
1
+ import { z } from 'zod';
2
+ export const KIT_TOOLS = ['upload', 'update', 'info'];
3
+ const HOUSE_ARGUMENTS = {"door":{"rooms/discover":{"type":"object","properties":{"prefixes":{"maxItems":256,"type":"array","items":{"type":"string"}},"operation_id":{"type":"string"}},"required":["prefixes"],"additionalProperties":false},"room-chunks/list":{"type":"object","properties":{"prefixes":{"maxItems":256,"type":"array","items":{"type":"string"}},"operation_id":{"type":"string"}},"required":["prefixes"],"additionalProperties":false},"changes/enumerate":{"type":"object","properties":{"prefixes":{"maxItems":256,"type":"array","items":{"type":"string"}},"positions":{"maxItems":256,"type":"array","items":{"type":"object","properties":{"authority":{"type":"string","minLength":1,"maxLength":128},"position":{"type":"string"},"log_epoch":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"page":{"type":"object","properties":{"through":{"type":"string"},"read":{"type":"integer","minimum":0,"maximum":2147483647}},"required":["through","read"],"additionalProperties":false}},"required":["authority","position","log_epoch"],"additionalProperties":false}},"operation_id":{"type":"string"}},"required":["prefixes","positions"],"additionalProperties":false},"files/revisions/list":{"type":"object","properties":{"path":{"type":"string","minLength":1},"revision":{"type":"string"},"before":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"limit":{"type":"integer","minimum":1,"maximum":200},"operation_id":{"type":"string"}},"required":["path"],"additionalProperties":false},"update":{"anyOf":[{"type":"object","properties":{"mount":{"type":"string","minLength":1},"changes":{"minItems":1,"maxItems":10000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"op":{"type":"string","const":"write"},"path":{"type":"string","minLength":1},"content":{"type":"string"},"base":{"type":"string","minLength":1,"maxLength":64}},"required":["op","path","content"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"edit"},"path":{"type":"string","minLength":1},"find":{"type":"string","minLength":1},"replace":{"type":"string"},"base":{"type":"string","minLength":1,"maxLength":64}},"required":["op","path","find","replace"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"move"},"path":{"type":"string","minLength":1},"to":{"type":"string","minLength":1},"base":{"anyOf":[{"type":"string","minLength":1,"maxLength":64},{"type":"object","propertyNames":{"type":"string","minLength":1},"additionalProperties":{"type":"string","minLength":1,"maxLength":64}}]}},"required":["op","path","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"delete"},"path":{"type":"string","minLength":1},"base":{"type":"string","minLength":1,"maxLength":64}},"required":["op","path"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"upload"},"path":{"type":"string","minLength":1},"base":{"type":"string","minLength":1,"maxLength":64},"local_id":{"type":"string","minLength":1,"maxLength":64},"bytes":{"type":"integer","minimum":0,"maximum":9007199254740991},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"media_type":{"type":"string","minLength":1,"maxLength":255}},"required":["op","path","bytes","sha256","media_type"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"mkdir"},"path":{"type":"string","minLength":1},"name":{"type":"string","maxLength":200},"from":{"type":"string","minLength":1,"maxLength":200},"content":{"type":"boolean"},"readme":{"type":"string"},"space":{"type":"string","minLength":1,"maxLength":200}},"required":["op","path"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"set"},"path":{"type":"string","minLength":1},"name":{"type":"string","maxLength":200},"time_zone":{"type":"string","maxLength":64},"public":{"type":"boolean"},"space":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]}},"required":["op","path"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"restore"},"path":{"type":"string","minLength":1},"ref":{"type":"string","minLength":1,"maxLength":200}},"required":["op","path"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"erase"},"path":{"type":"string","minLength":1},"ref":{"type":"string","minLength":1,"maxLength":200}},"required":["op","path"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"clear"},"room":{"type":"string","minLength":1,"maxLength":200}},"required":["op","room"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"trash_empty"},"room":{"type":"string","minLength":1,"maxLength":200}},"required":["op","room"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"versions_clear"},"room":{"type":"string","minLength":1,"maxLength":200}},"required":["op","room"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"trigger_create"},"room":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^\\r\\n\\u2028\\u2029]*$"},"condition":{"anyOf":[{"type":"object","properties":{"on":{"type":"string","const":"documents"},"query":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string"}},"pathPrefix":{"type":"string"},"paths":{"type":"array","items":{"type":"string"}},"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false},"new_documents":{"type":"boolean"},"changes":{"anyOf":[{"type":"string","const":"text"},{"type":"object","properties":{"field":{"type":"string"},"from":{"anyOf":[{"type":"array","items":{"type":["string","number","boolean","null"]}},{"type":"string","const":"new"}]},"to":{"anyOf":[{"type":"array","items":{"type":["string","number","boolean","null"]}},{"type":"string","const":"deleted"}]}},"required":["field"],"additionalProperties":false}]},"by":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"moved_between_rooms":{"type":"boolean"}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"items"},"query":{"type":"object","properties":{"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"notifications"},"query":{"type":"object","properties":{"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"messages"},"query":{"type":"object","properties":{"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"clock"},"cron":{"type":"string"},"time_zone":{"type":"string"}},"required":["on","cron"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"clock"},"query":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string"}},"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["types"],"additionalProperties":false},"date":{"type":"string"},"days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"at":{"type":"string"},"time_zone":{"type":"string"}},"required":["on","query","date","days","at"],"additionalProperties":false}]},"actions":{"minItems":1,"type":"array","items":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"notify"},"title":{"type":"string","minLength":1,"maxLength":200},"text":{"type":"string","minLength":1,"maxLength":4000},"to":{"type":"object","properties":{"users":{"default":[],"maxItems":64,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"fields":{"default":[],"maxItems":16,"type":"array","items":{"type":"string"}},"roles":{"default":[],"maxItems":16,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"additionalProperties":false},"in_group":{"default":false,"type":"boolean"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","title","text","to"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"agent_function"},"card":{"type":"string","pattern":"^[^/]+$"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","card"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"message"},"card":{"type":"string","pattern":"^[^/]+$"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","card"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"function"},"app":{"type":"string","pattern":"^a_([0123456789abcdefghjkmnpqrstvwxyz]+)\\.([0123456789abcdefghjkmnpqrstvwxyz])$"},"function":{"type":"string","pattern":"^[^\\p{Cc}]{1,64}$"},"attached_by":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"attach":{"default":false,"type":"boolean"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","app","function"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"function"},"function":{"type":"string","pattern":"^[^\\p{Cc}]{1,64}$"},"owner":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","function","owner"],"additionalProperties":false}]}},"enabled":{"type":"boolean"}},"required":["op","room","description","condition","actions"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"trigger_set"},"trigger":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"description":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^\\r\\n\\u2028\\u2029]*$"},"condition":{"anyOf":[{"type":"object","properties":{"on":{"type":"string","const":"documents"},"query":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string"}},"pathPrefix":{"type":"string"},"paths":{"type":"array","items":{"type":"string"}},"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false},"new_documents":{"type":"boolean"},"changes":{"anyOf":[{"type":"string","const":"text"},{"type":"object","properties":{"field":{"type":"string"},"from":{"anyOf":[{"type":"array","items":{"type":["string","number","boolean","null"]}},{"type":"string","const":"new"}]},"to":{"anyOf":[{"type":"array","items":{"type":["string","number","boolean","null"]}},{"type":"string","const":"deleted"}]}},"required":["field"],"additionalProperties":false}]},"by":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"moved_between_rooms":{"type":"boolean"}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"items"},"query":{"type":"object","properties":{"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"notifications"},"query":{"type":"object","properties":{"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"messages"},"query":{"type":"object","properties":{"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"clock"},"cron":{"type":"string"},"time_zone":{"type":"string"}},"required":["on","cron"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"clock"},"query":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string"}},"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["types"],"additionalProperties":false},"date":{"type":"string"},"days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"at":{"type":"string"},"time_zone":{"type":"string"}},"required":["on","query","date","days","at"],"additionalProperties":false}]},"actions":{"minItems":1,"type":"array","items":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"notify"},"title":{"type":"string","minLength":1,"maxLength":200},"text":{"type":"string","minLength":1,"maxLength":4000},"to":{"type":"object","properties":{"users":{"default":[],"maxItems":64,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"fields":{"default":[],"maxItems":16,"type":"array","items":{"type":"string"}},"roles":{"default":[],"maxItems":16,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"additionalProperties":false},"in_group":{"default":false,"type":"boolean"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","title","text","to"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"agent_function"},"card":{"type":"string","pattern":"^[^/]+$"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","card"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"message"},"card":{"type":"string","pattern":"^[^/]+$"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","card"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"function"},"app":{"type":"string","pattern":"^a_([0123456789abcdefghjkmnpqrstvwxyz]+)\\.([0123456789abcdefghjkmnpqrstvwxyz])$"},"function":{"type":"string","pattern":"^[^\\p{Cc}]{1,64}$"},"attached_by":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"attach":{"default":false,"type":"boolean"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","app","function"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"function"},"function":{"type":"string","pattern":"^[^\\p{Cc}]{1,64}$"},"owner":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","function","owner"],"additionalProperties":false}]}},"enabled":{"type":"boolean"},"action":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["op","trigger"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"trigger_delete"},"trigger":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["op","trigger"],"additionalProperties":false}]}},"runtime":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"app_ref":{"type":"string"},"release":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"operation_id":{"type":"string"}},"required":["changes"],"additionalProperties":false},{"type":"object","properties":{"mount":{"type":"string","minLength":1},"paths":{"minItems":1,"maxItems":2000,"type":"array","items":{"type":"string","minLength":1}},"upload":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"operation":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"bytes":{"type":"integer","minimum":3936001,"maximum":31999963},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"required":["url","operation","bytes","sha256"],"additionalProperties":false},"runtime":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"app_ref":{"type":"string"},"release":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"operation_id":{"type":"string"}},"required":["paths","upload"],"additionalProperties":false}]}},"tools":{"upload":{"type":"object","properties":{"file":{"anyOf":[{"type":"string","minLength":1},{"type":"object","properties":{"download_url":{"type":"string","format":"uri"},"file_id":{"type":"string","minLength":1},"mime_type":{"type":"string","minLength":1,"maxLength":255},"file_name":{"type":"string"}},"required":["download_url","file_id"],"additionalProperties":false}]},"path":{"type":"string","minLength":1},"base":{"type":"string","minLength":1},"bytes":{"type":"integer","minimum":0,"maximum":9007199254740991},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"media_type":{"type":"string","minLength":1,"maxLength":255},"upload":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"part_sha256":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"string","pattern":"^[0-9a-f]{64}$"}}},"additionalProperties":false},"update":{"type":"object","properties":{"changes":{"minItems":1,"maxItems":10000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"op":{"type":"string","const":"write"},"path":{"type":"string","minLength":1},"content":{"type":"string"},"base":{"type":"string","minLength":1,"maxLength":64}},"required":["op","path","content"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"edit"},"path":{"type":"string","minLength":1},"find":{"type":"string","minLength":1},"replace":{"type":"string"},"base":{"type":"string","minLength":1,"maxLength":64}},"required":["op","path","find","replace"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"move"},"path":{"type":"string","minLength":1},"to":{"type":"string","minLength":1},"base":{"anyOf":[{"type":"string","minLength":1,"maxLength":64},{"type":"object","propertyNames":{"type":"string","minLength":1},"additionalProperties":{"type":"string","minLength":1,"maxLength":64}}]}},"required":["op","path","to"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"delete"},"path":{"type":"string","minLength":1},"base":{"type":"string","minLength":1,"maxLength":64}},"required":["op","path"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"upload"},"path":{"type":"string","minLength":1},"base":{"type":"string","minLength":1,"maxLength":64},"local_id":{"type":"string","minLength":1,"maxLength":64},"bytes":{"type":"integer","minimum":0,"maximum":9007199254740991},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"media_type":{"type":"string","minLength":1,"maxLength":255}},"required":["op","path","bytes","sha256","media_type"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"mkdir"},"path":{"type":"string","minLength":1},"name":{"type":"string","maxLength":200},"from":{"type":"string","minLength":1,"maxLength":200},"content":{"type":"boolean"},"readme":{"type":"string"},"space":{"type":"string","minLength":1,"maxLength":200}},"required":["op","path"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"set"},"path":{"type":"string","minLength":1},"name":{"type":"string","maxLength":200},"time_zone":{"type":"string","maxLength":64},"public":{"type":"boolean"},"space":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]}},"required":["op","path"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"restore"},"path":{"type":"string","minLength":1},"ref":{"type":"string","minLength":1,"maxLength":200}},"required":["op","path"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"erase"},"path":{"type":"string","minLength":1},"ref":{"type":"string","minLength":1,"maxLength":200}},"required":["op","path"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"clear"},"room":{"type":"string","minLength":1,"maxLength":200}},"required":["op","room"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"trash_empty"},"room":{"type":"string","minLength":1,"maxLength":200}},"required":["op","room"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"versions_clear"},"room":{"type":"string","minLength":1,"maxLength":200}},"required":["op","room"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"trigger_create"},"room":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^\\r\\n\\u2028\\u2029]*$"},"condition":{"anyOf":[{"type":"object","properties":{"on":{"type":"string","const":"documents"},"query":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string"}},"pathPrefix":{"type":"string"},"paths":{"type":"array","items":{"type":"string"}},"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false},"new_documents":{"type":"boolean"},"changes":{"anyOf":[{"type":"string","const":"text"},{"type":"object","properties":{"field":{"type":"string"},"from":{"anyOf":[{"type":"array","items":{"type":["string","number","boolean","null"]}},{"type":"string","const":"new"}]},"to":{"anyOf":[{"type":"array","items":{"type":["string","number","boolean","null"]}},{"type":"string","const":"deleted"}]}},"required":["field"],"additionalProperties":false}]},"by":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"moved_between_rooms":{"type":"boolean"}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"items"},"query":{"type":"object","properties":{"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"notifications"},"query":{"type":"object","properties":{"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"messages"},"query":{"type":"object","properties":{"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"clock"},"cron":{"type":"string"},"time_zone":{"type":"string"}},"required":["on","cron"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"clock"},"query":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string"}},"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["types"],"additionalProperties":false},"date":{"type":"string"},"days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"at":{"type":"string"},"time_zone":{"type":"string"}},"required":["on","query","date","days","at"],"additionalProperties":false}]},"actions":{"minItems":1,"type":"array","items":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"notify"},"title":{"type":"string","minLength":1,"maxLength":200},"text":{"type":"string","minLength":1,"maxLength":4000},"to":{"type":"object","properties":{"users":{"default":[],"maxItems":64,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"fields":{"default":[],"maxItems":16,"type":"array","items":{"type":"string"}},"roles":{"default":[],"maxItems":16,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"additionalProperties":false},"in_group":{"default":false,"type":"boolean"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","title","text","to"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"agent_function"},"card":{"type":"string","pattern":"^[^/]+$"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","card"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"message"},"card":{"type":"string","pattern":"^[^/]+$"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","card"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"function"},"app":{"type":"string","pattern":"^a_([0123456789abcdefghjkmnpqrstvwxyz]+)\\.([0123456789abcdefghjkmnpqrstvwxyz])$"},"function":{"type":"string","pattern":"^[^\\p{Cc}]{1,64}$"},"attached_by":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"attach":{"default":false,"type":"boolean"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","app","function"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"function"},"function":{"type":"string","pattern":"^[^\\p{Cc}]{1,64}$"},"owner":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","function","owner"],"additionalProperties":false}]}},"enabled":{"type":"boolean"}},"required":["op","room","description","condition","actions"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"trigger_set"},"trigger":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"description":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^\\r\\n\\u2028\\u2029]*$"},"condition":{"anyOf":[{"type":"object","properties":{"on":{"type":"string","const":"documents"},"query":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string"}},"pathPrefix":{"type":"string"},"paths":{"type":"array","items":{"type":"string"}},"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false},"new_documents":{"type":"boolean"},"changes":{"anyOf":[{"type":"string","const":"text"},{"type":"object","properties":{"field":{"type":"string"},"from":{"anyOf":[{"type":"array","items":{"type":["string","number","boolean","null"]}},{"type":"string","const":"new"}]},"to":{"anyOf":[{"type":"array","items":{"type":["string","number","boolean","null"]}},{"type":"string","const":"deleted"}]}},"required":["field"],"additionalProperties":false}]},"by":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"moved_between_rooms":{"type":"boolean"}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"items"},"query":{"type":"object","properties":{"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"notifications"},"query":{"type":"object","properties":{"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"messages"},"query":{"type":"object","properties":{"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}},"required":["on"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"clock"},"cron":{"type":"string"},"time_zone":{"type":"string"}},"required":["on","cron"],"additionalProperties":false},{"type":"object","properties":{"on":{"type":"string","const":"clock"},"query":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string"}},"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["types"],"additionalProperties":false},"date":{"type":"string"},"days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"at":{"type":"string"},"time_zone":{"type":"string"}},"required":["on","query","date","days","at"],"additionalProperties":false}]},"actions":{"minItems":1,"type":"array","items":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"notify"},"title":{"type":"string","minLength":1,"maxLength":200},"text":{"type":"string","minLength":1,"maxLength":4000},"to":{"type":"object","properties":{"users":{"default":[],"maxItems":64,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"fields":{"default":[],"maxItems":16,"type":"array","items":{"type":"string"}},"roles":{"default":[],"maxItems":16,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"additionalProperties":false},"in_group":{"default":false,"type":"boolean"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","title","text","to"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"agent_function"},"card":{"type":"string","pattern":"^[^/]+$"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","card"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"message"},"card":{"type":"string","pattern":"^[^/]+$"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","card"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"function"},"app":{"type":"string","pattern":"^a_([0123456789abcdefghjkmnpqrstvwxyz]+)\\.([0123456789abcdefghjkmnpqrstvwxyz])$"},"function":{"type":"string","pattern":"^[^\\p{Cc}]{1,64}$"},"attached_by":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"attach":{"default":false,"type":"boolean"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","app","function"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"function"},"function":{"type":"string","pattern":"^[^\\p{Cc}]{1,64}$"},"owner":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"enabled":{"default":true,"type":"boolean"}},"required":["kind","function","owner"],"additionalProperties":false}]}},"enabled":{"type":"boolean"},"action":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["op","trigger"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"trigger_delete"},"trigger":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["op","trigger"],"additionalProperties":false}]}},"upload":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"operation":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"bytes":{"type":"integer","minimum":3936001,"maximum":31999963},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"required":["url","operation","bytes","sha256"],"additionalProperties":false},"mount":{"type":"string","minLength":1},"op":{"type":"string","const":"stage"},"paths":{"minItems":1,"maxItems":2000,"type":"array","items":{"type":"string","minLength":1}},"bytes":{"type":"integer","minimum":3936001,"maximum":31999963},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"additionalProperties":false},"info":{"type":"object","properties":{"path":{"type":"string","minLength":1},"ref":{"type":"string","minLength":1},"app":{"type":"string","minLength":1},"agent":{"type":"string","minLength":1},"environment":{"type":"string","minLength":1},"conversation":{"type":"string","minLength":1},"view":{"type":"string","enum":["sources"]},"history":{"type":"boolean"},"events":{"type":"boolean"},"errors":{"type":"boolean"},"query":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cursor":{"type":"string","minLength":1}},"additionalProperties":false}}};
4
+ function declared(shapes) {
5
+ return Object.fromEntries(Object.entries(shapes ?? {}).map(([name, shape]) => [
6
+ name,
7
+ z.fromJSONSchema(shape),
8
+ ]));
9
+ }
10
+ export const KIT_DOOR_ARGUMENTS = declared(HOUSE_ARGUMENTS.door);
11
+ export const KIT_TOOL_ARGUMENTS = declared(HOUSE_ARGUMENTS.tools);
@@ -31,6 +31,7 @@ export declare const KIT_CALL_RESULT: z.ZodUnion<readonly [z.ZodObject<{
31
31
  }, z.core.$strict>;
32
32
  }, z.core.$strict>, z.ZodObject<{}, z.core.$strict>]>;
33
33
  export type KitCallResult = z.infer<typeof KIT_CALL_RESULT>;
34
+ export declare const SESSION_CHOICE_BYTES_MAX = 128;
34
35
  export declare const KIT_CALLS: {
35
36
  open: z.ZodObject<{
36
37
  type: z.ZodLiteral<"input">;
@@ -39,6 +40,8 @@ export declare const KIT_CALLS: {
39
40
  agent_id: z.ZodUUID;
40
41
  provider_session_id: z.ZodNullable<z.ZodString>;
41
42
  kind: z.ZodLiteral<"open">;
43
+ model: z.ZodOptional<z.ZodString>;
44
+ effort: z.ZodOptional<z.ZodString>;
42
45
  afk: z.ZodOptional<z.ZodLiteral<true>>;
43
46
  }, z.core.$strict>;
44
47
  kill: z.ZodObject<{
@@ -49,14 +52,6 @@ export declare const KIT_CALLS: {
49
52
  provider_session_id: z.ZodNullable<z.ZodString>;
50
53
  kind: z.ZodLiteral<"kill">;
51
54
  }, z.core.$strict>;
52
- done: z.ZodObject<{
53
- type: z.ZodLiteral<"input">;
54
- input_id: z.ZodUUID;
55
- conversation_id: z.ZodUUID;
56
- agent_id: z.ZodUUID;
57
- provider_session_id: z.ZodNullable<z.ZodString>;
58
- kind: z.ZodLiteral<"done">;
59
- }, z.core.$strict>;
60
55
  message: z.ZodObject<{
61
56
  type: z.ZodLiteral<"input">;
62
57
  input_id: z.ZodUUID;
@@ -64,6 +59,8 @@ export declare const KIT_CALLS: {
64
59
  agent_id: z.ZodUUID;
65
60
  provider_session_id: z.ZodNullable<z.ZodString>;
66
61
  kind: z.ZodLiteral<"message">;
62
+ model: z.ZodOptional<z.ZodString>;
63
+ effort: z.ZodOptional<z.ZodString>;
67
64
  message_id: z.ZodUUID;
68
65
  text: z.ZodString;
69
66
  first: z.ZodBoolean;
@@ -96,6 +93,8 @@ export declare const KIT_CALLS: {
96
93
  agent_id: z.ZodUUID;
97
94
  provider_session_id: z.ZodNullable<z.ZodString>;
98
95
  kind: z.ZodLiteral<"answer">;
96
+ model: z.ZodOptional<z.ZodString>;
97
+ effort: z.ZodOptional<z.ZodString>;
99
98
  interaction_id: z.ZodUUID;
100
99
  response: z.ZodUnknown;
101
100
  request: z.ZodUnknown;
@@ -107,8 +106,8 @@ export declare const KIT_CALLS: {
107
106
  agent_id: z.ZodUUID;
108
107
  provider_session_id: z.ZodNullable<z.ZodString>;
109
108
  kind: z.ZodLiteral<"option">;
110
- option: z.ZodString;
111
- value: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
109
+ model: z.ZodOptional<z.ZodString>;
110
+ effort: z.ZodOptional<z.ZodString>;
112
111
  }, z.core.$strict>;
113
112
  sign_in: z.ZodObject<{
114
113
  type: z.ZodLiteral<"input">;
@@ -170,6 +169,8 @@ export declare const KIT_CALL: z.ZodDiscriminatedUnion<[z.ZodObject<{
170
169
  agent_id: z.ZodUUID;
171
170
  provider_session_id: z.ZodNullable<z.ZodString>;
172
171
  kind: z.ZodLiteral<"open">;
172
+ model: z.ZodOptional<z.ZodString>;
173
+ effort: z.ZodOptional<z.ZodString>;
173
174
  afk: z.ZodOptional<z.ZodLiteral<true>>;
174
175
  }, z.core.$strict>, z.ZodObject<{
175
176
  type: z.ZodLiteral<"input">;
@@ -178,13 +179,6 @@ export declare const KIT_CALL: z.ZodDiscriminatedUnion<[z.ZodObject<{
178
179
  agent_id: z.ZodUUID;
179
180
  provider_session_id: z.ZodNullable<z.ZodString>;
180
181
  kind: z.ZodLiteral<"kill">;
181
- }, z.core.$strict>, z.ZodObject<{
182
- type: z.ZodLiteral<"input">;
183
- input_id: z.ZodUUID;
184
- conversation_id: z.ZodUUID;
185
- agent_id: z.ZodUUID;
186
- provider_session_id: z.ZodNullable<z.ZodString>;
187
- kind: z.ZodLiteral<"done">;
188
182
  }, z.core.$strict>, z.ZodObject<{
189
183
  type: z.ZodLiteral<"input">;
190
184
  input_id: z.ZodUUID;
@@ -192,6 +186,8 @@ export declare const KIT_CALL: z.ZodDiscriminatedUnion<[z.ZodObject<{
192
186
  agent_id: z.ZodUUID;
193
187
  provider_session_id: z.ZodNullable<z.ZodString>;
194
188
  kind: z.ZodLiteral<"message">;
189
+ model: z.ZodOptional<z.ZodString>;
190
+ effort: z.ZodOptional<z.ZodString>;
195
191
  message_id: z.ZodUUID;
196
192
  text: z.ZodString;
197
193
  first: z.ZodBoolean;
@@ -221,6 +217,8 @@ export declare const KIT_CALL: z.ZodDiscriminatedUnion<[z.ZodObject<{
221
217
  agent_id: z.ZodUUID;
222
218
  provider_session_id: z.ZodNullable<z.ZodString>;
223
219
  kind: z.ZodLiteral<"answer">;
220
+ model: z.ZodOptional<z.ZodString>;
221
+ effort: z.ZodOptional<z.ZodString>;
224
222
  interaction_id: z.ZodUUID;
225
223
  response: z.ZodUnknown;
226
224
  request: z.ZodUnknown;
@@ -231,8 +229,8 @@ export declare const KIT_CALL: z.ZodDiscriminatedUnion<[z.ZodObject<{
231
229
  agent_id: z.ZodUUID;
232
230
  provider_session_id: z.ZodNullable<z.ZodString>;
233
231
  kind: z.ZodLiteral<"option">;
234
- option: z.ZodString;
235
- value: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
232
+ model: z.ZodOptional<z.ZodString>;
233
+ effort: z.ZodOptional<z.ZodString>;
236
234
  }, z.core.$strict>, z.ZodObject<{
237
235
  type: z.ZodLiteral<"input">;
238
236
  input_id: z.ZodUUID;
@@ -42,10 +42,22 @@ function environmentCall(kind, params) {
42
42
  return z.strictObject({ ...ENVIRONMENT_CALL, kind: z.literal(kind), ...params });
43
43
  }
44
44
  const AFK = z.literal(true).optional();
45
+ export const SESSION_CHOICE_BYTES_MAX = 128;
46
+ const SESSION_CHOICE = z
47
+ .string()
48
+ .min(1)
49
+ .refine((value) => new TextEncoder().encode(value).length <= SESSION_CHOICE_BYTES_MAX);
50
+ const STARTING_CHOICES = {
51
+ model: SESSION_CHOICE.optional().meta({
52
+ description: "Present only for a conversation with its own model: the model a session this call starts or resumes runs, in the Agent's place.",
53
+ }),
54
+ effort: SESSION_CHOICE.optional().meta({
55
+ description: "Present only for a conversation with its own effort: the effort a session this call starts or resumes runs, in the Agent's place.",
56
+ }),
57
+ };
45
58
  export const KIT_CALLS = {
46
- open: conversationCall('open', { afk: AFK }),
59
+ open: conversationCall('open', { afk: AFK, ...STARTING_CHOICES }),
47
60
  kill: conversationCall('kill', {}),
48
- done: conversationCall('done', {}),
49
61
  message: conversationCall('message', {
50
62
  message_id: z.uuid(),
51
63
  text: z.string(),
@@ -53,6 +65,7 @@ export const KIT_CALLS = {
53
65
  at_once: z.literal(true).optional(),
54
66
  recent: z.string().optional(),
55
67
  afk: AFK,
68
+ ...STARTING_CHOICES,
56
69
  }),
57
70
  take_out: conversationCall('take_out', { message_id: z.uuid() }),
58
71
  interrupt: conversationCall('interrupt', { turn_id: z.uuid() }),
@@ -60,10 +73,15 @@ export const KIT_CALLS = {
60
73
  interaction_id: z.uuid(),
61
74
  response: z.unknown(),
62
75
  request: z.unknown(),
76
+ ...STARTING_CHOICES,
63
77
  }),
64
78
  option: conversationCall('option', {
65
- option: z.string(),
66
- value: z.union([z.string(), z.boolean()]),
79
+ model: SESSION_CHOICE.optional().meta({
80
+ description: 'Present only for a change of the model: the model the running process takes.',
81
+ }),
82
+ effort: SESSION_CHOICE.optional().meta({
83
+ description: 'Present only for a change of the effort: the effort the running process takes.',
84
+ }),
67
85
  }),
68
86
  sign_in: environmentCall('sign_in', {
69
87
  cli: z.string(),
@@ -89,7 +107,6 @@ export const KIT_CALLS = {
89
107
  export const KIT_CALL = z.discriminatedUnion('kind', [
90
108
  KIT_CALLS.open,
91
109
  KIT_CALLS.kill,
92
- KIT_CALLS.done,
93
110
  KIT_CALLS.message,
94
111
  KIT_CALLS.take_out,
95
112
  KIT_CALLS.interrupt,
package/dist/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
- export { HOUSE_ONE_WAY_CALLS, KIT_CALL, KIT_CALL_RESULT, KIT_CALLS, KIT_CAUSE, KIT_CONNECTION_PATH, KIT_CONNECTION_PROTOCOL_PREFIX, KIT_ONE_WAY_CALLS, KIT_SETTINGS, STARTING_STEPS, } from './connection.ts';
1
+ export { HOUSE_ONE_WAY_CALLS, KIT_CALL, KIT_CALL_RESULT, KIT_CALLS, KIT_CAUSE, KIT_CONNECTION_PATH, KIT_CONNECTION_PROTOCOL_PREFIX, KIT_ONE_WAY_CALLS, KIT_SETTINGS, SESSION_CHOICE_BYTES_MAX, STARTING_STEPS, } from './connection.ts';
2
2
  export type { HouseOneWayCall, HouseOneWayCallOf, KitCall, KitCallOf, KitCallResult, KitMethod, KitOneWayCall, KitOneWayCallOf, KitSettings, } from './connection.ts';
3
- export { AGENT_CAPABILITY_DECLARATION, DECLARED_SECRET_CEREMONY, DESIRED_AGENT_ROUTE, DESIRED_AGENTS, ENVIRONMENT_FORMS, FILE_BYTES, FILE_NAME, FILE_NAME_MAX, KIT_ACTS, KIT_BINARY_CHANGE, KIT_DOOR_ACTS, KIT_QUESTION, KIT_REINSTALLS, KIT_TURN_END, KIT_TURN_IMAGE, KIT_UPLOAD_FINISH, LOCAL_COPY_ROOM, MEDIA_TYPE, PART_SHA256, REPORTED_AGENT_KIND, SECRET_CEREMONY_STEPS_MAX, SECRET_RELAY_OUTCOME, SECRET_RELAY_RELEASES, SHA256, TRANSCRIPT, } from './acts.ts';
3
+ export { AGENT_CAPABILITY_DECLARATION, DECLARED_SECRET_CEREMONY, DESIRED_AGENT_ROUTE, DESIRED_AGENTS, ENVIRONMENT_FORMS, FILE_BYTES, FILE_NAME, FILE_NAME_MAX, FUNCTION_RUN_META_KEY, KIT_ACTS, KIT_BINARY_CHANGE, KIT_DOOR_ACTS, KIT_QUESTION, KIT_REINSTALLS, KIT_TURN_END, KIT_TURN_IMAGE, KIT_UPLOAD_FINISH, LOCAL_COPY_ROOM, MEDIA_TYPE, PART_SHA256, REPORTED_AGENT_KIND, SECRET_CEREMONY_STEPS_MAX, SECRET_RELAY_OUTCOME, SECRET_RELAY_RELEASES, SHA256, TRANSCRIPT, } from './acts.ts';
4
4
  export type { AgentCapabilityDeclaration, DeclaredSecretCeremony, DesiredAgentRoute, KitActAnswer, KitActDeclaration, KitActName, KitActRequest, KitBinaryChange, KitDoorAct, KitDoorAnswer, KitQuestion, KitTurnEnd, KitTurnImage, LocalCopyRoom, ReportedAgentKind, SecretCeremonyStep, SecretRelayOutcome, Transcript, TranscriptionReport, } from './acts.ts';
5
5
  export { ENVIRONMENT_REACHES, ENVIRONMENT_ROOM_LIMIT, ENVIRONMENT_ROOM_REFS, ENVIRONMENT_ROOMS, KIT_ENROLLMENT_ACTS, KIT_LOGIN_ISSUED, KIT_LOGIN_PATHS, KIT_LOGIN_POLL, KIT_LOGIN_START, KIT_LOGIN_STARTED, } from './enrollment.ts';
6
6
  export type { EnvironmentReach, EnvironmentRooms, KitEnrollmentAct } from './enrollment.ts';
package/dist/index.js CHANGED
@@ -1,4 +1,4 @@
1
- export { HOUSE_ONE_WAY_CALLS, KIT_CALL, KIT_CALL_RESULT, KIT_CALLS, KIT_CAUSE, KIT_CONNECTION_PATH, KIT_CONNECTION_PROTOCOL_PREFIX, KIT_ONE_WAY_CALLS, KIT_SETTINGS, STARTING_STEPS, } from './connection.js';
2
- export { AGENT_CAPABILITY_DECLARATION, DECLARED_SECRET_CEREMONY, DESIRED_AGENT_ROUTE, DESIRED_AGENTS, ENVIRONMENT_FORMS, FILE_BYTES, FILE_NAME, FILE_NAME_MAX, KIT_ACTS, KIT_BINARY_CHANGE, KIT_DOOR_ACTS, KIT_QUESTION, KIT_REINSTALLS, KIT_TURN_END, KIT_TURN_IMAGE, KIT_UPLOAD_FINISH, LOCAL_COPY_ROOM, MEDIA_TYPE, PART_SHA256, REPORTED_AGENT_KIND, SECRET_CEREMONY_STEPS_MAX, SECRET_RELAY_OUTCOME, SECRET_RELAY_RELEASES, SHA256, TRANSCRIPT, } from './acts.js';
1
+ export { HOUSE_ONE_WAY_CALLS, KIT_CALL, KIT_CALL_RESULT, KIT_CALLS, KIT_CAUSE, KIT_CONNECTION_PATH, KIT_CONNECTION_PROTOCOL_PREFIX, KIT_ONE_WAY_CALLS, KIT_SETTINGS, SESSION_CHOICE_BYTES_MAX, STARTING_STEPS, } from './connection.js';
2
+ export { AGENT_CAPABILITY_DECLARATION, DECLARED_SECRET_CEREMONY, DESIRED_AGENT_ROUTE, DESIRED_AGENTS, ENVIRONMENT_FORMS, FILE_BYTES, FILE_NAME, FILE_NAME_MAX, FUNCTION_RUN_META_KEY, KIT_ACTS, KIT_BINARY_CHANGE, KIT_DOOR_ACTS, KIT_QUESTION, KIT_REINSTALLS, KIT_TURN_END, KIT_TURN_IMAGE, KIT_UPLOAD_FINISH, LOCAL_COPY_ROOM, MEDIA_TYPE, PART_SHA256, REPORTED_AGENT_KIND, SECRET_CEREMONY_STEPS_MAX, SECRET_RELAY_OUTCOME, SECRET_RELAY_RELEASES, SHA256, TRANSCRIPT, } from './acts.js';
3
3
  export { ENVIRONMENT_REACHES, ENVIRONMENT_ROOM_LIMIT, ENVIRONMENT_ROOM_REFS, ENVIRONMENT_ROOMS, KIT_ENROLLMENT_ACTS, KIT_LOGIN_ISSUED, KIT_LOGIN_PATHS, KIT_LOGIN_POLL, KIT_LOGIN_START, KIT_LOGIN_STARTED, } from './enrollment.js';
4
4
  export { BUILDING_KIT, KIT_COMMANDS, KIT_DECLARATION, KIT_WIRE, KIT_WIRE_HEADER, kitWire, kitWireRefusal, } from './wire.js';
package/dist/wire.d.ts CHANGED
@@ -26,6 +26,8 @@ export declare const KIT_DECLARATION: {
26
26
  agent_id: z.ZodUUID;
27
27
  provider_session_id: z.ZodNullable<z.ZodString>;
28
28
  kind: z.ZodLiteral<"open">;
29
+ model: z.ZodOptional<z.ZodString>;
30
+ effort: z.ZodOptional<z.ZodString>;
29
31
  afk: z.ZodOptional<z.ZodLiteral<true>>;
30
32
  }, z.core.$strict>;
31
33
  kill: z.ZodObject<{
@@ -36,14 +38,6 @@ export declare const KIT_DECLARATION: {
36
38
  provider_session_id: z.ZodNullable<z.ZodString>;
37
39
  kind: z.ZodLiteral<"kill">;
38
40
  }, z.core.$strict>;
39
- done: z.ZodObject<{
40
- type: z.ZodLiteral<"input">;
41
- input_id: z.ZodUUID;
42
- conversation_id: z.ZodUUID;
43
- agent_id: z.ZodUUID;
44
- provider_session_id: z.ZodNullable<z.ZodString>;
45
- kind: z.ZodLiteral<"done">;
46
- }, z.core.$strict>;
47
41
  message: z.ZodObject<{
48
42
  type: z.ZodLiteral<"input">;
49
43
  input_id: z.ZodUUID;
@@ -51,6 +45,8 @@ export declare const KIT_DECLARATION: {
51
45
  agent_id: z.ZodUUID;
52
46
  provider_session_id: z.ZodNullable<z.ZodString>;
53
47
  kind: z.ZodLiteral<"message">;
48
+ model: z.ZodOptional<z.ZodString>;
49
+ effort: z.ZodOptional<z.ZodString>;
54
50
  message_id: z.ZodUUID;
55
51
  text: z.ZodString;
56
52
  first: z.ZodBoolean;
@@ -83,6 +79,8 @@ export declare const KIT_DECLARATION: {
83
79
  agent_id: z.ZodUUID;
84
80
  provider_session_id: z.ZodNullable<z.ZodString>;
85
81
  kind: z.ZodLiteral<"answer">;
82
+ model: z.ZodOptional<z.ZodString>;
83
+ effort: z.ZodOptional<z.ZodString>;
86
84
  interaction_id: z.ZodUUID;
87
85
  response: z.ZodUnknown;
88
86
  request: z.ZodUnknown;
@@ -94,8 +92,8 @@ export declare const KIT_DECLARATION: {
94
92
  agent_id: z.ZodUUID;
95
93
  provider_session_id: z.ZodNullable<z.ZodString>;
96
94
  kind: z.ZodLiteral<"option">;
97
- option: z.ZodString;
98
- value: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
95
+ model: z.ZodOptional<z.ZodString>;
96
+ effort: z.ZodOptional<z.ZodString>;
99
97
  }, z.core.$strict>;
100
98
  sign_in: z.ZodObject<{
101
99
  type: z.ZodLiteral<"input">;
@@ -442,6 +440,9 @@ export declare const KIT_DECLARATION: {
442
440
  }, z.core.$strict>>;
443
441
  }, z.core.$strict>;
444
442
  }, z.core.$strict>>;
443
+ 'function-runs/credentials/issue': import("./acts.ts").KitActDeclaration<"run", z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
444
+ credential: z.ZodString;
445
+ }, z.core.$strict>>;
445
446
  };
446
447
  door: readonly ["rooms/discover", "room-chunks/list", "changes/enumerate", "files/revisions/list", "update"];
447
448
  changes: {
@@ -452,6 +453,9 @@ export declare const KIT_DECLARATION: {
452
453
  sha256: z.ZodString;
453
454
  }, z.core.$strip>;
454
455
  };
456
+ meta: {
457
+ run: string;
458
+ };
455
459
  login: {
456
460
  paths: {
457
461
  readonly start: '/kit';
package/dist/wire.js CHANGED
@@ -1,6 +1,6 @@
1
1
  import { createHash } from 'node:crypto';
2
2
  import { z } from 'zod';
3
- import { KIT_ACTS, KIT_BINARY_CHANGE, KIT_DOOR_ACTS } from './acts.js';
3
+ import { FUNCTION_RUN_META_KEY, KIT_ACTS, KIT_BINARY_CHANGE, KIT_DOOR_ACTS } from './acts.js';
4
4
  import { HOUSE_ONE_WAY_CALLS, KIT_CALL_RESULT, KIT_CALLS, KIT_CONNECTION_PATH, KIT_CONNECTION_PROTOCOL_PREFIX, KIT_ONE_WAY_CALLS, } from './connection.js';
5
5
  import { KIT_LOGIN_ISSUED, KIT_LOGIN_PATHS, KIT_LOGIN_POLL, KIT_LOGIN_START, KIT_LOGIN_STARTED, } from './enrollment.js';
6
6
  const WIRE_HEX_LENGTH = 16;
@@ -23,6 +23,7 @@ export const KIT_DECLARATION = {
23
23
  acts: KIT_ACTS,
24
24
  door: KIT_DOOR_ACTS,
25
25
  changes: { binary: KIT_BINARY_CHANGE },
26
+ meta: { run: FUNCTION_RUN_META_KEY },
26
27
  login: {
27
28
  paths: KIT_LOGIN_PATHS,
28
29
  start: { request: KIT_LOGIN_START, answer: KIT_LOGIN_STARTED },
@@ -48,7 +49,7 @@ export function kitWire(declaration) {
48
49
  .digest('hex')
49
50
  .slice(0, WIRE_HEX_LENGTH);
50
51
  }
51
- export const KIT_WIRE = 'a2dfd0b44abddc1e';
52
+ export const KIT_WIRE = '4fd16810492940d7';
52
53
  export function kitWireRefusal(named) {
53
54
  if (typeof named !== 'string')
54
55
  return 'kit_declaration_invalid';
package/package.json CHANGED
@@ -1,6 +1,5 @@
1
1
  {
2
2
  "name": "@agentshouse/kit-wire",
3
- "version": "0.1.0-caf9c7b612dda",
4
3
  "description": "The Kit wire: every shape House and the Kit exchange, the Kit connection's frames and every /kit/ request and answer, and the wire computed from them",
5
4
  "license": "MIT",
6
5
  "type": "module",
@@ -16,6 +15,10 @@
16
15
  "types": "./dist/index.d.ts",
17
16
  "default": "./dist/index.js"
18
17
  },
18
+ "./arguments": {
19
+ "types": "./dist/arguments.d.ts",
20
+ "default": "./dist/arguments.js"
21
+ },
19
22
  "./package.json": "./package.json"
20
23
  },
21
24
  "files": [
@@ -30,5 +33,6 @@
30
33
  "type": "git",
31
34
  "url": "git+https://github.com/agentshouse/core.git",
32
35
  "directory": "kit-wire"
33
- }
36
+ },
37
+ "version": "0.1.0-cc189684f4a10"
34
38
  }