@sixb/core 0.1.20 → 0.1.22

package/dist/activity/connection.d.ts

@@ -0,0 +1,62 @@
+import type { SixbRuntimeContext } from "../runtime/types";
+import type { ActivityVisit, StoredActivityVisitPage } from "../storage/activity/types";
+import type { ShareGrantRecord } from "../storage/share-grants";
+import { type ActivityDevice } from "./device";
+import type { ActivityService } from "./service";
+export type ActivityConnectionStatus = "active" | "expired" | "revoked";
+/** A signed-in session. No address or token is kept here. */
+export interface ActivitySessionConnection {
+    readonly type: "session";
+    readonly device: ActivityDevice;
+    /** A native client's own label, such as a CLI's. */
+    readonly clientName?: string;
+    readonly status: ActivityConnectionStatus;
+    readonly createdAt: Date;
+    readonly lastSeenAt?: Date;
+    readonly revokedAt?: Date;
+}
+/** The shared link a visitor opened, and the session it gave them. */
+export interface ActivityShareConnection {
+    readonly type: "share";
+    readonly grantId: string;
+    /** Absent once the link's grant is gone. */
+    readonly definitionId?: string;
+    readonly status: ActivityConnectionStatus;
+    readonly createdAt: Date;
+    readonly revokedAt?: Date;
+}
+export type ActivityConnection = ActivitySessionConnection | ActivityShareConnection;
+/** A user's sign-in, with the visits it opened. */
+export interface ActivityUserConnection extends ActivitySessionConnection {
+    /** Every visit the session opened. */
+    readonly visits: number;
+    /** Its latest visits, newest first. */
+    readonly latestVisits: readonly ActivityVisit[];
+}
+export interface ActivityConnectionsPage {
+    readonly connections: readonly ActivityUserConnection[];
+    /** Pass it back as `cursor` for the next, older connections; absent on the last page. */
+    readonly nextCursor?: string;
+}
+export interface ActivityConnectionsQuery {
+    readonly userId: string;
+    /** 1 to 100. Default: 20. */
+    readonly limit?: number;
+    /** The previous page's `nextCursor`. */
+    readonly cursor?: string;
+}
+/** Where a list of sessions continues: a creation time, and how many created then it returned. */
+export interface ActivityConnectionsCursor {
+    readonly createdAt: Date;
+    readonly skip: number;
+}
+/** A user's sign-ins, newest first, revoked and expired ones too: one read per store. */
+export declare function readActivityConnections(runtime: SixbRuntimeContext, service: ActivityService, query: ActivityConnectionsQuery, now: Date): Promise<ActivityConnectionsPage>;
+export declare function encodeActivityConnectionsCursor(cursor: ActivityConnectionsCursor): string;
+export declare function decodeActivityConnectionsCursor(value: string): ActivityConnectionsCursor;
+/**
+ * The session a visit came through: a sign-in, or a shared link, whose grant the caller read with
+ * the visit's share name.
+ */
+export declare function readActivityConnection(runtime: SixbRuntimeContext, page: StoredActivityVisitPage, grant: ShareGrantRecord | undefined, now: Date): Promise<ActivityConnection | undefined>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/activity/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/activity/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAEvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,UAAU,CAAA;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAEhD,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA;AAEvE,6DAA6D;AAC7D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,oDAAoD;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAA;IACzC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,CAAA;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CAC1B;AAED,sEAAsE;AACtE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,4CAA4C;IAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAA;IACzC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CAC1B;AAED,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,GAAG,uBAAuB,CAAA;AAEpF,mDAAmD;AACnD,MAAM,WAAW,sBAAuB,SAAQ,yBAAyB;IACvE,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,uCAAuC;IACvC,QAAQ,CAAC,YAAY,EAAE,SAAS,aAAa,EAAE,CAAA;CAChD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,SAAS,sBAAsB,EAAE,CAAA;IACvD,yFAAyF;IACzF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,kGAAkG;AAClG,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,yFAAyF;AACzF,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,wBAAwB,EAC/B,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,uBAAuB,CAAC,CAgClC;AAkBD,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAIzF;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,yBAAyB,CAcxF;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,uBAAuB,EAC7B,KAAK,EAAE,gBAAgB,GAAG,SAAS,EACnC,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAoCzC"}

package/dist/activity/device.d.ts

@@ -0,0 +1,8 @@
+/** What a user agent says about the device that signed in. Display only, never authorization. */
+export interface ActivityDevice {
+    readonly browser?: string;
+    readonly os?: string;
+}
+/** The browser and operating system a user agent names, when it names a common one. */
+export declare function describeUserAgent(userAgent: string | undefined): ActivityDevice;
+//# sourceMappingURL=device.d.ts.map

package/dist/activity/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/activity/device.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CACrB;AAuBD,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAY/E"}

package/dist/activity/execution.d.ts

@@ -0,0 +1,48 @@
+import type { SixbRuntimeContext } from "../runtime/types";
+import type { ActivityEventInput, ActivitySummary, ActivityUser } from "../storage/activity/types";
+import { type ActivityConnectionsPage, type ActivityConnectionsQuery } from "./connection";
+import type { ActivityCalendar, ActivityCalendarQuery, ActivityCaptureOptions, ActivityCaptureResult, ActivityPageQuery, ActivityPeriodQuery, ActivityService } from "./service";
+import { type ActivityVisitView } from "./shares";
+import { type ActivityVisitTimeline } from "./timeline";
+export interface ActivityVisitList {
+    readonly visits: readonly ActivityVisitView[];
+    readonly hasMore: boolean;
+}
+export interface ActivityUsersResult {
+    /** `displayName` is the account's profile name; no other profile field is read. */
+    readonly users: readonly (ActivityUser & {
+        readonly displayName?: string;
+    })[];
+    readonly hasMore: boolean;
+}
+/** `sixb.activity`: the app's recorded visits. Every read needs `can.observe(project.activity)`. */
+export interface ActivityRuntime {
+    /** Shared visits name their link's share: see `ActivityVisitView`. */
+    list(query: ActivityPageQuery): Promise<ActivityVisitList>;
+    users(query: ActivityPageQuery): Promise<ActivityUsersResult>;
+    summarize(query: ActivityPeriodQuery): Promise<ActivitySummary>;
+    calendar(query: ActivityCalendarQuery): Promise<ActivityCalendar>;
+    /**
+     * The visit's page views and interactions with the actions, workflows and Agent runs its session
+     * started, and the connection it came through. Bounded: see `truncated`.
+     */
+    timeline(visitId: string): Promise<ActivityVisitTimeline | null>;
+    /** A user's sign-ins, newest first, with the visits each opened. */
+    connections(query: ActivityConnectionsQuery): Promise<ActivityConnectionsPage>;
+}
+/**
+ * Recording, for the server's capture route only: it is not on `sixb.activity`, so project code
+ * cannot record visits under whatever authority it runs with.
+ */
+export interface ActivityCaptureRuntime {
+    /** The settings a browser session reads before it sends anything. */
+    captureOptions(): ActivityCaptureOptions;
+    /** Records a batch for the calling user or shared session. */
+    capture(events: readonly ActivityEventInput[]): Promise<ActivityCaptureResult>;
+}
+export declare function createActivityRuntime(runtime: SixbRuntimeContext, service: ActivityService): ActivityRuntime;
+export declare function createActivityCaptureRuntime(runtime: SixbRuntimeContext, service: ActivityService): ActivityCaptureRuntime;
+export declare function registerActivityCaptureRuntime(owner: object, capture: ActivityCaptureRuntime): void;
+/** The recording side of a bound SDK, such as a request's. */
+export declare function getActivityCaptureRuntime(owner: object): ActivityCaptureRuntime;
+//# sourceMappingURL=execution.d.ts.map

package/dist/activity/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/activity/execution.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAClG,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAE9B,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EAEhB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,KAAK,iBAAiB,EAAqC,MAAM,UAAU,CAAA;AACpF,OAAO,EAEL,KAAK,qBAAqB,EAE3B,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC7C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,YAAY,GAAG;QAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAA;IAC7E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED,oGAAoG;AACpG,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC1D,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAC7D,SAAS,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC/D,QAAQ,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACjE;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAA;IAChE,oEAAoE;IACpE,WAAW,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;CAC/E;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,cAAc,IAAI,sBAAsB,CAAA;IACxC,8DAA8D;IAC9D,OAAO,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;CAC/E;AAKD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,eAAe,GACvB,eAAe,CAoDjB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,eAAe,GACvB,sBAAsB,CAWxB;AAQD,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CAON;AAED,8DAA8D;AAC9D,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAM/E"}

package/dist/activity/service.d.ts

@@ -0,0 +1,79 @@
+import type { ActivityActor, ActivityCursor, ActivityDay, ActivityEventInput, ActivitySessionVisits, ActivityStorage, ActivitySummary, ActivityUsersPage, ActivityVisitsPage, ListActivitySessionVisitsInput, StoredActivityVisitPage } from "../storage/activity/types";
+import { type ActivityConnectionsCursor, type ActivityConnectionsQuery } from "./connection";
+export interface ActivityOptions {
+    /**
+     * Record visits, page views and marked interactions in the project's app and its shared links.
+     * Off by default.
+     */
+    readonly enabled?: boolean;
+    /** A new visit begins after this long without foreground activity. Default: 30 minutes. */
+    readonly idleTimeoutMs?: number;
+}
+/** What a browser needs to know before it sends anything. */
+export interface ActivityCaptureOptions {
+    readonly enabled: boolean;
+    readonly idleTimeoutMs: number;
+}
+export interface ActivityCaptureResult {
+    readonly status: "accepted" | "throttled" | "disabled";
+    readonly accepted: number;
+}
+/** Visits active in `[from, to)`, at most 31 days, and the page views received in it. */
+export interface ActivityPeriodQuery {
+    readonly from: Date;
+    readonly to: Date;
+    /** Only this account's visits. */
+    readonly userId?: string;
+}
+export interface ActivityPageQuery extends ActivityPeriodQuery {
+    /** 1 to 100. Default: 50. */
+    readonly limit?: number;
+    /** The last row of the previous page: its `lastSeenAt`, and its visit or user id. */
+    readonly before?: ActivityCursor;
+}
+export interface ActivityCalendarQuery {
+    readonly userId: string;
+    /** A UTC calendar year. */
+    readonly year: number;
+}
+export interface ActivityCalendar {
+    readonly userId: string;
+    readonly year: number;
+    readonly days: readonly ActivityDay[];
+}
+/** The session whose browser sent a batch, from its verified authorization. */
+export interface ActivitySource {
+    readonly actor: ActivityActor;
+    readonly sessionId: string;
+}
+/** Validates queries and holds the project's activity settings. Authorization is the caller's. */
+export declare class ActivityService {
+    private readonly projectId;
+    private readonly storage;
+    private readonly now;
+    readonly captureOptions: ActivityCaptureOptions;
+    constructor(projectId: string, storage: ActivityStorage | undefined, options?: ActivityOptions, now?: () => Date);
+    capture(source: ActivitySource, events: readonly ActivityEventInput[]): Promise<ActivityCaptureResult>;
+    list(query: ActivityPageQuery): Promise<ActivityVisitsPage>;
+    users(query: ActivityPageQuery): Promise<ActivityUsersPage>;
+    summarize(query: ActivityPeriodQuery): Promise<ActivitySummary>;
+    calendar(query: ActivityCalendarQuery): Promise<ActivityCalendar>;
+    /**
+     * A visit, its first page views, and the session it belongs to: the timeline joins on it, and it
+     * never leaves core.
+     */
+    readWithSession(input: {
+        readonly id: string;
+        readonly limit: number;
+    }): Promise<StoredActivityVisitPage | null>;
+    connectionsQuery(query: ActivityConnectionsQuery): {
+        readonly userId: string;
+        readonly limit: number;
+        readonly before?: ActivityConnectionsCursor;
+    };
+    /** Each session's visit count and latest visits: a connection shows those, the calendar the rest. */
+    sessionVisits(input: Omit<ListActivitySessionVisitsInput, "projectId" | "limit">): Promise<readonly ActivitySessionVisits[]>;
+    private period;
+    private requireStorage;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/activity/service.d.ts.map

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

package/dist/activity/shares.d.ts

@@ -0,0 +1,24 @@
+import type { SixbRuntimeContext } from "../runtime/types";
+import type { ActivityActor, ActivityVisit } from "../storage/activity/types";
+import type { ShareGrantRecord } from "../storage/share-grants";
+/** Who a visit belongs to, as `sixb.activity` returns it: a shared link also names its share. */
+export type ActivityVisitActor = Extract<ActivityActor, {
+    readonly type: "user";
+}> | (Extract<ActivityActor, {
+    readonly type: "share";
+}> & {
+    /** The link's share definition; absent once its grant is gone. */
+    readonly definitionId?: string;
+});
+/** A visit as `sixb.activity` returns it. */
+export interface ActivityVisitView extends Omit<ActivityVisit, "actor"> {
+    readonly actor: ActivityVisitActor;
+}
+/** Visits named by their links' shares, from one grant read for all of them. */
+export declare function nameSharedVisits(runtime: SixbRuntimeContext, visits: readonly ActivityVisit[]): Promise<readonly ActivityVisitView[]>;
+/** One visit named by its link's share, with that link's grant when it still exists. */
+export declare function nameSharedVisit(runtime: SixbRuntimeContext, visit: ActivityVisit): Promise<{
+    readonly visit: ActivityVisitView;
+    readonly grant?: ShareGrantRecord;
+}>;
+//# sourceMappingURL=shares.d.ts.map

package/dist/activity/shares.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shares.d.ts","sourceRoot":"","sources":["../../src/activity/shares.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE/D,iGAAiG;AACjG,MAAM,MAAM,kBAAkB,GAC1B,OAAO,CAAC,aAAa,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACjD,CAAC,OAAO,CAAC,aAAa,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG;IACpD,kEAAkE;IAClE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B,CAAC,CAAA;AAEN,6CAA6C;AAC7C,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC;IACrE,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;CACnC;AAED,gFAAgF;AAChF,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,SAAS,aAAa,EAAE,GAC/B,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAGvC;AAED,wFAAwF;AACxF,wBAAsB,eAAe,CACnC,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC;IAAE,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAKnF"}

package/dist/activity/timeline.d.ts

@@ -0,0 +1,103 @@
+import type { SixbRuntimeContext } from "../runtime/types";
+import type { ActionRunStatus } from "../storage/action-runs";
+import type { StoredActivityVisitPage } from "../storage/activity/types";
+import type { AgentRunStatus } from "../storage/agents";
+import type { AiCostSummary } from "../storage/ai-cost";
+import type { ShareGrantRecord } from "../storage/share-grants";
+import type { WorkflowRunStatus } from "../storage/workflow-runs";
+import { type ActivityConnection } from "./connection";
+import type { ActivityVisitView } from "./shares";
+/**
+ * At most this many page views and interactions together, and as many recorded executions, make a
+ * visit's timeline.
+ */
+export declare const ACTIVITY_TIMELINE_LIMIT = 200;
+export interface ActivityPageEntry {
+    readonly kind: "page";
+    readonly at: Date;
+    readonly sequence: number;
+    readonly route: string;
+}
+/** An interaction the app marked, on the page it happened on. */
+export interface ActivityInteractionEntry {
+    readonly kind: "interaction";
+    readonly at: Date;
+    readonly sequence: number;
+    readonly name: string;
+    readonly route: string;
+}
+export interface ActivityActionEntry {
+    readonly kind: "action";
+    readonly at: Date;
+    readonly executionId: string;
+    readonly actionId: string;
+    readonly runId: string;
+    /** `incomplete` when no outcome is recorded: the run is in flight, or was interrupted. */
+    readonly status: ActionRunStatus | "incomplete";
+    /** Whether the viewer may read the run itself, as Observability › Runs shows it. */
+    readonly runVisible: boolean;
+    /** The object it applied to, only when the viewer can read that object. */
+    readonly object?: {
+        readonly objectTypeId: string;
+        readonly primaryId: string;
+    };
+}
+export interface ActivityWorkflowEntry {
+    readonly kind: "workflow";
+    readonly at: Date;
+    readonly executionId: string;
+    readonly workflowId: string;
+    readonly runId: string;
+    readonly status: WorkflowRunStatus | "incomplete";
+    /** Whether the viewer may read the run itself, as Observability › Runs shows it. */
+    readonly runVisible: boolean;
+}
+/** A conversation's run: its metadata, and its thread's title only for those who read threads. */
+export interface ActivityAgentEntry {
+    readonly kind: "agent";
+    readonly at: Date;
+    readonly executionId: string;
+    readonly runId: string;
+    readonly threadId: string;
+    /**
+     * Present only when the viewer can read the conversation, with `can.observe(agent.threads)`.
+     * Activity alone never shows a title or a message.
+     */
+    readonly thread?: {
+        readonly title?: string;
+    };
+    readonly status: AgentRunStatus;
+    /** Messages in the thread now, every run's. */
+    readonly messages: number;
+    /** The run's model calls with those of its subagents and tools; absent without any. */
+    readonly cost?: AiCostSummary;
+}
+export type ActivityTimelineEntry = ActivityPageEntry | ActivityInteractionEntry | ActivityActionEntry | ActivityWorkflowEntry | ActivityAgentEntry;
+export interface ActivityVisitTimeline {
+    readonly visit: ActivityVisitView;
+    /** Absent once the session is gone, or without an auth or share store. */
+    readonly connection?: ActivityConnection;
+    /**
+     * By time. Page views and interactions come in their sequence, and before executions at the same
+     * instant.
+     */
+    readonly entries: readonly ActivityTimelineEntry[];
+    /**
+     * More than {@link ACTIVITY_TIMELINE_LIMIT} page views and interactions, or recorded executions.
+     * The timeline then stops at the last page view or interaction, or the last root execution, it
+     * could keep.
+     */
+    readonly truncated: boolean;
+}
+/**
+ * A visit's timeline: its page views and interactions, and what its session started while it
+ * lasted. One bounded read per source, each batched over the visit; see `README.md`.
+ */
+export declare function composeActivityTimeline(runtime: SixbRuntimeContext, input: {
+    readonly page: StoredActivityVisitPage;
+    /** The visit, named by its link's share. */
+    readonly visit: ActivityVisitView;
+    /** That link's grant, read with the name. */
+    readonly grant?: ShareGrantRecord;
+}, now: Date): Promise<ActivityVisitTimeline>;
+//# sourceMappingURL=timeline.d.ts.map

package/dist/activity/timeline.d.ts.map

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

package/dist/agents/accounting.d.ts

@@ -0,0 +1,15 @@
+import type { SixbRuntimeContext } from "../runtime/types";
+import type { AiCostSummary } from "../storage/ai-cost";
+import type { AiModelCallUsage } from "../storage/ai-usage";
+/**
+ * Each turn's usage and cost: its own calls and those of everything below it, its children and
+ * what its tools ran, as Activity counts them. Each call counts once, toward the nearest turn above
+ * it. A child still at work adds what it has spent so far, and so does a workflow a tool started,
+ * also once the turn has ended: Activity counts it toward the conversation the same way. A child's
+ * execution counts the same way when it is the one asked about.
+ */
+export declare function resolveTurnAccounting(runtime: SixbRuntimeContext, executionIds: readonly string[]): Promise<readonly {
+    readonly usage?: AiModelCallUsage;
+    readonly cost?: AiCostSummary;
+}[]>;
+//# sourceMappingURL=accounting.d.ts.map

package/dist/agents/accounting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounting.d.ts","sourceRoot":"","sources":["../../src/agents/accounting.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAE3D;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,EAC3B,YAAY,EAAE,SAAS,MAAM,EAAE,GAC9B,OAAO,CAAC,SAAS;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAA;CAAE,EAAE,CAAC,CAyC1F"}

package/dist/agents/adapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/agents/adapters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,YAAY,EAMb,MAAM,WAAW,CAAA;AAElB,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EAGZ,iBAAiB,EAClB,MAAM,WAAW,CAAA;AAElB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAEnD,4FAA4F;AAC5F,eAAO,MAAM,8BAA8B,gMACoJ,CAAA;AAE/L,MAAM,WAAW,0BAA0B,CAAC,QAAQ,SAAS,YAAY,GAAG,YAAY;IACtF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAA;IAClB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,gCAAgC,CAAC,QAAQ,SAAS,YAAY,GAAG,YAAY;IAC5F,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAA;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,sBAAsB,CAAC,QAAQ,SAAS,YAAY,GAAG,YAAY;IAClF;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EACd,CAAC,CAAC,KAAK,EAAE,0BAA0B,CAAC,QAAQ,CAAC,KAAK,GAAG,GAAG,uBAAuB,GAAG,SAAS,CAAC,GAC5F,SAAS,CAAA;IACb;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,CAAC,QAAQ,CAAC,KAAK,MAAM,GAAG,SAAS,CAAA;IACvF;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,MAAM,GAAG,SAAS,CAAA;IACtE,wFAAwF;IACxF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAC5B,KAAK,EAAE,gCAAgC,CAAC,QAAQ,CAAC,KAC9C,MAAM,GAAG,SAAS,CAAA;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,SAAS,YAAY,EAC3D,QAAQ,EAAE,SAAS,QAAQ,EAAE,EAC7B,OAAO,GAAE,sBAAsB,CAAC,QAAQ,CAAM,GAC7C,YAAY,EAAE,CAgBhB"}
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/agents/adapters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,YAAY,EAMb,MAAM,WAAW,CAAA;AAIlB,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EAGZ,iBAAiB,EAClB,MAAM,WAAW,CAAA;AAElB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAEnD,4FAA4F;AAC5F,eAAO,MAAM,8BAA8B,gMACoJ,CAAA;AAE/L,MAAM,WAAW,0BAA0B,CAAC,QAAQ,SAAS,YAAY,GAAG,YAAY;IACtF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAA;IAClB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,gCAAgC,CAAC,QAAQ,SAAS,YAAY,GAAG,YAAY;IAC5F,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAA;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,sBAAsB,CAAC,QAAQ,SAAS,YAAY,GAAG,YAAY;IAClF;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EACd,CAAC,CAAC,KAAK,EAAE,0BAA0B,CAAC,QAAQ,CAAC,KAAK,GAAG,GAAG,uBAAuB,GAAG,SAAS,CAAC,GAC5F,SAAS,CAAA;IACb;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,CAAC,QAAQ,CAAC,KAAK,MAAM,GAAG,SAAS,CAAA;IACvF;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,MAAM,GAAG,SAAS,CAAA;IACtE,wFAAwF;IACxF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAC5B,KAAK,EAAE,gCAAgC,CAAC,QAAQ,CAAC,KAC9C,MAAM,GAAG,SAAS,CAAA;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,SAAS,YAAY,EAC3D,QAAQ,EAAE,SAAS,QAAQ,EAAE,EAC7B,OAAO,GAAE,sBAAsB,CAAC,QAAQ,CAAM,GAC7C,YAAY,EAAE,CAgBhB"}

package/dist/agents/agent-mail.d.ts

@@ -0,0 +1,9 @@
+import type { AgentMailPart } from "./message";
+/**
+ * What the model reads for an {@link AgentMailPart}. The live delivery and a later run's replay of
+ * the child's thread both project it here, so a continuation's prefix keeps its bytes. The
+ * sender's text is escaped: it may quote what a tool read, and must not close the block or pass
+ * for one of Sixb's own.
+ */
+export declare function agentMailInstruction(part: AgentMailPart): string;
+//# sourceMappingURL=agent-mail.d.ts.map

package/dist/agents/agent-mail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-mail.d.ts","sourceRoot":"","sources":["../../src/agents/agent-mail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAM9C;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAQhE"}

package/dist/agents/api-gateway.d.ts

@@ -1,3 +1,4 @@
+import { type AgentApiEffect } from "../http/api-routes";
 export declare const AGENT_API_GATEWAY_PREFIX = "/__sixb/agent-api";
 export interface AgentApiGatewayCapabilityInput {
     readonly projectId: string;
@@ -7,6 +8,8 @@ export interface AgentApiGatewayCapabilityInput {
 export interface AgentApiRoute {
     readonly method: string;
     readonly path: string;
+    /** What a call changes; a GET reads. */
+    readonly effect: AgentApiEffect;
 }
 /**
  * The routes the agent API gateway may proxy — the `agentApi` projection of the canonical
@@ -18,4 +21,6 @@ export declare function isValidAgentApiGatewayCapability(input: AgentApiGatewayC
     readonly capability: string;
 }): boolean;
 export declare function isAllowedAgentApiRequest(method: string, pathname: string): boolean;
+/** The gateway route a request matches, with what it changes. */
+export declare function findAgentApiRoute(method: string, pathname: string): AgentApiRoute | undefined;
 //# sourceMappingURL=api-gateway.d.ts.map

package/dist/agents/api-gateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-gateway.d.ts","sourceRoot":"","sources":["../../src/agents/api-gateway.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,wBAAwB,sBAAsB,CAAA;AAI3D,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAES,CAAA;AAE9D,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,8BAA8B,GAAG,MAAM,CAE7F;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,8BAA8B,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACtE,OAAO,CAST;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMlF"}
+{"version":3,"file":"api-gateway.d.ts","sourceRoot":"","sources":["../../src/agents/api-gateway.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,oBAAoB,CAAA;AAGzE,eAAO,MAAM,wBAAwB,sBAAsB,CAAA;AAI3D,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAChC;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAMlD,CAAA;AAEH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,8BAA8B,GAAG,MAAM,CAE7F;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,8BAA8B,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACtE,OAAO,CAST;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAElF;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAM7F"}

package/dist/agents/approval-continuation.d.ts

@@ -0,0 +1,23 @@
+import type { Sixb } from "../runtime/sixb";
+import type { AgentTurnResume } from "./request";
+/** Where a resume left the paused turn, as whoever asked it learns. */
+export type AgentApprovalResume = AgentTurnResume
+/**
+ * The turn could not resume as its requester: an AI limit, a lost grant or a thread they left.
+ * `retrying`: Sixb tries again; otherwise the thread's next message reports the calls.
+ */
+ | {
+    readonly status: "refused";
+    readonly code: string;
+    readonly message: string;
+    readonly retrying: boolean;
+};
+/**
+ * Let code without a request resume a paused turn with a bound SDK's authority: the worker, after a
+ * turn paused on calls already decided, and its repair pass. The call side of a decision is the
+ * host's approval executor.
+ */
+export declare function registerAgentTurnResume(agent: object, resume: (runId: string) => Promise<AgentApprovalResume>): void;
+/** Resume a paused turn as the bound SDK's principal, its requester. */
+export declare function resumeDecidedAgentTurn(sixb: Sixb, runId: string): Promise<AgentApprovalResume>;
+//# sourceMappingURL=approval-continuation.d.ts.map

package/dist/agents/approval-continuation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-continuation.d.ts","sourceRoot":"","sources":["../../src/agents/approval-continuation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAEhD,uEAAuE;AACvE,MAAM,MAAM,mBAAmB,GAC3B,eAAe;AACjB;;;GAGG;GACD;IACE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC3B,CAAA;AAQL;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,GACtD,IAAI,CAON;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAM9F"}

package/dist/agents/approval-executor.d.ts

@@ -0,0 +1,56 @@
+import type { Broker } from "../broker";
+import type { ExecutionScope } from "../execution/types";
+import type { ActionRunRecord } from "../storage/action-runs";
+import type { AgentApprovalRecord, AgentStorage } from "../storage/agents";
+import type { WorkflowRunRecord } from "../storage/workflow-runs";
+import { type AgentRunScopeHost } from "./run-scope";
+export interface AgentApprovalHost extends AgentRunScopeHost {
+    readonly storage: AgentRunScopeHost["storage"] & {
+        readonly agents?: AgentStorage;
+        readonly actionRuns?: {
+            getById(params: {
+                projectId: string;
+                id: string;
+            }): Promise<ActionRunRecord | null>;
+        };
+        readonly workflowRuns?: {
+            getById(params: {
+                projectId: string;
+                id: string;
+            }): Promise<WorkflowRunRecord | null>;
+        };
+    };
+    readonly broker: Broker;
+    withScope(scope: ExecutionScope): object;
+}
+/**
+ * The request that decides, as its own bound SDK carries it. The call runs with this authority: the
+ * requester's grants and credential at decision time, not those the turn started with.
+ */
+export type AgentApprovalDecider = ExecutionScope;
+/** Runs the calls a host's requesters approve. */
+export interface AgentApprovalExecutor {
+    /** Run the call the caller's decision just approved, and record its outcome. */
+    run(approval: AgentApprovalRecord, decider: AgentApprovalDecider): Promise<AgentApprovalRecord>;
+    /**
+     * Run an approved call a crash left without its outcome, as the run that made it, with the
+     * authority its turn holds now. When that authority has ended, the outcome says so and the call
+     * does not run. The caller holds the call's execution claim.
+     */
+    complete(approval: AgentApprovalRecord): Promise<AgentApprovalRecord>;
+    /**
+     * The outcome of a call another decision approved, without starting it: the outcome of the run
+     * this process is making, or the one the call's run recorded. Without either, the approval comes
+     * back as it is.
+     */
+    settle(approval: AgentApprovalRecord): Promise<AgentApprovalRecord>;
+}
+export declare function createAgentApprovalExecutor(host: AgentApprovalHost): AgentApprovalExecutor;
+/**
+ * Attach the host's approval executor to the host, for its workers, and to its context.
+ * Enumerable, like the Action run executor, so that the runtime context of every bound SDK carries
+ * it: deciding needs to bind another execution.
+ */
+export declare function registerAgentApprovalExecutor(owner: object, executor: AgentApprovalExecutor): void;
+export declare function getAgentApprovalExecutor(owner: object): AgentApprovalExecutor;
+//# sourceMappingURL=approval-executor.d.ts.map

package/dist/agents/approval-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-executor.d.ts","sourceRoot":"","sources":["../../src/agents/approval-executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAKvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EAGV,mBAAmB,EACnB,YAAY,EACb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAIjE,OAAO,EAEL,KAAK,iBAAiB,EAEvB,MAAM,aAAa,CAAA;AAEpB,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,GAAG;QAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAA;QAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE;YACpB,OAAO,CAAC,MAAM,EAAE;gBAAE,SAAS,EAAE,MAAM,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAA;aAAE,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;SACpF,CAAA;QACD,QAAQ,CAAC,YAAY,CAAC,EAAE;YACtB,OAAO,CAAC,MAAM,EAAE;gBAAE,SAAS,EAAE,MAAM,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAA;aAAE,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;SACtF,CAAA;KACF,CAAA;IACD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAAA;CACzC;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAA;AAEjD,kDAAkD;AAClD,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,GAAG,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAC/F;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACrE;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;CACpE;AAmOD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,iBAAiB,GAAG,qBAAqB,CAE1F;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,qBAAqB,GAC9B,IAAI,CAON;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAQ7E"}

package/dist/agents/approval-outcome.d.ts

@@ -0,0 +1,8 @@
+import type { AgentApprovalOutcomePart } from "./message";
+/**
+ * What the model reads for an {@link AgentApprovalOutcomePart}: how a call it made, and that
+ * answered `awaiting_approval`, ended. Until such a block comes, the call is not done. A call one
+ * of its sub-agents made says so, and whether the sub-agent continues, as the part recorded it.
+ */
+export declare function approvalOutcomeInstruction(part: AgentApprovalOutcomePart): string;
+//# sourceMappingURL=approval-outcome.d.ts.map

package/dist/agents/approval-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-outcome.d.ts","sourceRoot":"","sources":["../../src/agents/approval-outcome.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA4B,wBAAwB,EAAE,MAAM,WAAW,CAAA;AAEnF;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,CAYjF"}