@kitman-sh/sdk 0.7.4 → 0.8.0

package/types/packages/core/src/notification.d.ts

@@ -1,6 +1,6 @@
 import * as Schema from 'effect/Schema';
 import type { WorkspaceNotificationPreferences } from './workspace';
-export declare const NotificationKinds: readonly ['question_waiting', 'run_failed', 'review_ready', 'no_runner', 'proposal_waiting', 'assigned', 'mentioned', 'commented', 'state_changed', 'run_finished', 'drift_unresolved', 'run_progress', 'change_request_update', 'start_blocked'];
+export declare const NotificationKinds: readonly ['question_waiting', 'run_failed', 'review_ready', 'no_runner', 'proposal_waiting', 'approval_waiting', 'assigned', 'mentioned', 'commented', 'state_changed', 'run_finished', 'drift_unresolved', 'run_progress', 'change_request_update', 'start_blocked', 'update_drafted', 'runner_problem'];
 export type NotificationKind = (typeof NotificationKinds)[number];
 /** The facts a Notification's fixed templates render; never Outputs, transcripts, source or secrets. */
 export declare const NotificationPayload: Schema.Struct<{
@@ -8,6 +8,9 @@ export declare const NotificationPayload: Schema.Struct<{
     readonly taskTitle: Schema.optionalKey<Schema.String>;
     readonly loopTitle: Schema.optionalKey<Schema.String>;
     readonly proposalTitle: Schema.optionalKey<Schema.String>;
+    /** The Code Mode operation a hosted MCP approval waits on. */
+    readonly toolName: Schema.optionalKey<Schema.String>;
+    readonly workspaceName: Schema.optionalKey<Schema.String>;
     /** The Question's name, the Run's status, or the drifted constraint. */
     readonly cause: Schema.optionalKey<Schema.String>;
     /** The state a Task moved to. */
@@ -15,19 +18,31 @@ export declare const NotificationPayload: Schema.Struct<{
     readonly changeRequestUrl: Schema.optionalKey<Schema.String>;
     /** What a Run needs that Kitman could not choose, such as its Loop or repository. */
     readonly missing: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly projectName: Schema.optionalKey<Schema.String>;
+    /** What a drafted Project Update was written from, since the Update before it. */
+    readonly writtenFrom: Schema.optionalKey<Schema.Struct<{
+        readonly runs: Schema.Int;
+        readonly taskChanges: Schema.Int;
+        readonly since: Schema.optionalKey<Schema.String>;
+    }>>;
+    readonly runnerName: Schema.optionalKey<Schema.String>;
+    /** A Runner Problem and the one command or action that fixes it. */
+    readonly problem: Schema.optionalKey<Schema.String>;
+    readonly fix: Schema.optionalKey<Schema.String>;
 }>;
 export type NotificationPayload = (typeof NotificationPayload)['Type'];
 export declare const NotificationSubject: Schema.Struct<{
-    readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">]>;
+    readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">, Schema.Literal<"memory">, Schema.Literal<"mcp_approval">, Schema.Literal<"project_update">, Schema.Literal<"runner">]>;
     readonly id: Schema.String;
 }>;
 export declare const Notification: Schema.Struct<{
     readonly id: Schema.String;
     readonly workspaceId: Schema.String;
     readonly recipientUserId: Schema.String;
-    readonly kind: Schema.Literals<readonly ["question_waiting", "run_failed", "review_ready", "no_runner", "proposal_waiting", "assigned", "mentioned", "commented", "state_changed", "run_finished", "drift_unresolved", "run_progress", "change_request_update", "start_blocked"]>;
+    readonly kind: Schema.Literals<readonly ["question_waiting", "run_failed", "review_ready", "no_runner", "proposal_waiting", "approval_waiting", "assigned", "mentioned", "commented", "state_changed", "run_finished", "drift_unresolved", "run_progress", "change_request_update", "start_blocked", "update_drafted", "runner_problem"]>;
     readonly subject: Schema.Struct<{
-        readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">]>;
+        readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">, Schema.Literal<"memory">, Schema.Literal<"mcp_approval">, Schema.Literal<"project_update">, Schema.Literal<"runner">]>;
         readonly id: Schema.String;
     }>;
     /** Empty when Kitman acted. */
@@ -38,6 +53,9 @@ export declare const Notification: Schema.Struct<{
         readonly taskTitle: Schema.optionalKey<Schema.String>;
         readonly loopTitle: Schema.optionalKey<Schema.String>;
         readonly proposalTitle: Schema.optionalKey<Schema.String>;
+        /** The Code Mode operation a hosted MCP approval waits on. */
+        readonly toolName: Schema.optionalKey<Schema.String>;
+        readonly workspaceName: Schema.optionalKey<Schema.String>;
         /** The Question's name, the Run's status, or the drifted constraint. */
         readonly cause: Schema.optionalKey<Schema.String>;
         /** The state a Task moved to. */
@@ -45,6 +63,18 @@ export declare const Notification: Schema.Struct<{
         readonly changeRequestUrl: Schema.optionalKey<Schema.String>;
         /** What a Run needs that Kitman could not choose, such as its Loop or repository. */
         readonly missing: Schema.optionalKey<Schema.$Array<Schema.String>>;
+        readonly projectId: Schema.optionalKey<Schema.String>;
+        readonly projectName: Schema.optionalKey<Schema.String>;
+        /** What a drafted Project Update was written from, since the Update before it. */
+        readonly writtenFrom: Schema.optionalKey<Schema.Struct<{
+            readonly runs: Schema.Int;
+            readonly taskChanges: Schema.Int;
+            readonly since: Schema.optionalKey<Schema.String>;
+        }>>;
+        readonly runnerName: Schema.optionalKey<Schema.String>;
+        /** A Runner Problem and the one command or action that fixes it. */
+        readonly problem: Schema.optionalKey<Schema.String>;
+        readonly fix: Schema.optionalKey<Schema.String>;
     }>;
     readonly title: Schema.String;
     readonly body: Schema.String;
@@ -59,7 +89,7 @@ export type InboxFilter = (typeof InboxFilters)[number];
 /** One subject's Notifications for its recipient, newest first; the item a person works in their Inbox. */
 export declare const InboxItem: Schema.Struct<{
     readonly subject: Schema.Struct<{
-        readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">]>;
+        readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">, Schema.Literal<"memory">, Schema.Literal<"mcp_approval">, Schema.Literal<"project_update">, Schema.Literal<"runner">]>;
         readonly id: Schema.String;
     }>;
     /** What the item asks of its recipient, until it is done. */
@@ -72,9 +102,9 @@ export declare const InboxItem: Schema.Struct<{
         readonly id: Schema.String;
         readonly workspaceId: Schema.String;
         readonly recipientUserId: Schema.String;
-        readonly kind: Schema.Literals<readonly ["question_waiting", "run_failed", "review_ready", "no_runner", "proposal_waiting", "assigned", "mentioned", "commented", "state_changed", "run_finished", "drift_unresolved", "run_progress", "change_request_update", "start_blocked"]>;
+        readonly kind: Schema.Literals<readonly ["question_waiting", "run_failed", "review_ready", "no_runner", "proposal_waiting", "approval_waiting", "assigned", "mentioned", "commented", "state_changed", "run_finished", "drift_unresolved", "run_progress", "change_request_update", "start_blocked", "update_drafted", "runner_problem"]>;
         readonly subject: Schema.Struct<{
-            readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">]>;
+            readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">, Schema.Literal<"memory">, Schema.Literal<"mcp_approval">, Schema.Literal<"project_update">, Schema.Literal<"runner">]>;
             readonly id: Schema.String;
         }>;
         /** Empty when Kitman acted. */
@@ -85,6 +115,9 @@ export declare const InboxItem: Schema.Struct<{
             readonly taskTitle: Schema.optionalKey<Schema.String>;
             readonly loopTitle: Schema.optionalKey<Schema.String>;
             readonly proposalTitle: Schema.optionalKey<Schema.String>;
+            /** The Code Mode operation a hosted MCP approval waits on. */
+            readonly toolName: Schema.optionalKey<Schema.String>;
+            readonly workspaceName: Schema.optionalKey<Schema.String>;
             /** The Question's name, the Run's status, or the drifted constraint. */
             readonly cause: Schema.optionalKey<Schema.String>;
             /** The state a Task moved to. */
@@ -92,6 +125,18 @@ export declare const InboxItem: Schema.Struct<{
             readonly changeRequestUrl: Schema.optionalKey<Schema.String>;
             /** What a Run needs that Kitman could not choose, such as its Loop or repository. */
             readonly missing: Schema.optionalKey<Schema.$Array<Schema.String>>;
+            readonly projectId: Schema.optionalKey<Schema.String>;
+            readonly projectName: Schema.optionalKey<Schema.String>;
+            /** What a drafted Project Update was written from, since the Update before it. */
+            readonly writtenFrom: Schema.optionalKey<Schema.Struct<{
+                readonly runs: Schema.Int;
+                readonly taskChanges: Schema.Int;
+                readonly since: Schema.optionalKey<Schema.String>;
+            }>>;
+            readonly runnerName: Schema.optionalKey<Schema.String>;
+            /** A Runner Problem and the one command or action that fixes it. */
+            readonly problem: Schema.optionalKey<Schema.String>;
+            readonly fix: Schema.optionalKey<Schema.String>;
         }>;
         readonly title: Schema.String;
         readonly body: Schema.String;
@@ -104,7 +149,7 @@ export type InboxItem = (typeof InboxItem)['Type'];
 export declare const InboxList: Schema.Struct<{
     readonly items: Schema.$Array<Schema.Struct<{
         readonly subject: Schema.Struct<{
-            readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">]>;
+            readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">, Schema.Literal<"memory">, Schema.Literal<"mcp_approval">, Schema.Literal<"project_update">, Schema.Literal<"runner">]>;
             readonly id: Schema.String;
         }>;
         /** What the item asks of its recipient, until it is done. */
@@ -117,9 +162,9 @@ export declare const InboxList: Schema.Struct<{
             readonly id: Schema.String;
             readonly workspaceId: Schema.String;
             readonly recipientUserId: Schema.String;
-            readonly kind: Schema.Literals<readonly ["question_waiting", "run_failed", "review_ready", "no_runner", "proposal_waiting", "assigned", "mentioned", "commented", "state_changed", "run_finished", "drift_unresolved", "run_progress", "change_request_update", "start_blocked"]>;
+            readonly kind: Schema.Literals<readonly ["question_waiting", "run_failed", "review_ready", "no_runner", "proposal_waiting", "approval_waiting", "assigned", "mentioned", "commented", "state_changed", "run_finished", "drift_unresolved", "run_progress", "change_request_update", "start_blocked", "update_drafted", "runner_problem"]>;
             readonly subject: Schema.Struct<{
-                readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">]>;
+                readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">, Schema.Literal<"memory">, Schema.Literal<"mcp_approval">, Schema.Literal<"project_update">, Schema.Literal<"runner">]>;
                 readonly id: Schema.String;
             }>;
             /** Empty when Kitman acted. */
@@ -130,6 +175,9 @@ export declare const InboxList: Schema.Struct<{
                 readonly taskTitle: Schema.optionalKey<Schema.String>;
                 readonly loopTitle: Schema.optionalKey<Schema.String>;
                 readonly proposalTitle: Schema.optionalKey<Schema.String>;
+                /** The Code Mode operation a hosted MCP approval waits on. */
+                readonly toolName: Schema.optionalKey<Schema.String>;
+                readonly workspaceName: Schema.optionalKey<Schema.String>;
                 /** The Question's name, the Run's status, or the drifted constraint. */
                 readonly cause: Schema.optionalKey<Schema.String>;
                 /** The state a Task moved to. */
@@ -137,6 +185,18 @@ export declare const InboxList: Schema.Struct<{
                 readonly changeRequestUrl: Schema.optionalKey<Schema.String>;
                 /** What a Run needs that Kitman could not choose, such as its Loop or repository. */
                 readonly missing: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                readonly projectId: Schema.optionalKey<Schema.String>;
+                readonly projectName: Schema.optionalKey<Schema.String>;
+                /** What a drafted Project Update was written from, since the Update before it. */
+                readonly writtenFrom: Schema.optionalKey<Schema.Struct<{
+                    readonly runs: Schema.Int;
+                    readonly taskChanges: Schema.Int;
+                    readonly since: Schema.optionalKey<Schema.String>;
+                }>>;
+                readonly runnerName: Schema.optionalKey<Schema.String>;
+                /** A Runner Problem and the one command or action that fixes it. */
+                readonly problem: Schema.optionalKey<Schema.String>;
+                readonly fix: Schema.optionalKey<Schema.String>;
             }>;
             readonly title: Schema.String;
             readonly body: Schema.String;
@@ -155,14 +215,14 @@ export declare const InboxCounts: Schema.Struct<{
 export type InboxCounts = (typeof InboxCounts)['Type'];
 export declare const InboxSubjects: Schema.Struct<{
     readonly subjects: Schema.$Array<Schema.Struct<{
-        readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">]>;
+        readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">, Schema.Literal<"memory">, Schema.Literal<"mcp_approval">, Schema.Literal<"project_update">, Schema.Literal<"runner">]>;
         readonly id: Schema.String;
     }>>;
 }>;
 export type InboxSubjects = (typeof InboxSubjects)['Type'];
 export declare const InboxSnooze: Schema.Struct<{
     readonly subjects: Schema.$Array<Schema.Struct<{
-        readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">]>;
+        readonly kind: Schema.Union<readonly [Schema.Literal<"task">, Schema.Literal<"run">, Schema.Literal<"proposal">, Schema.Literal<"memory">, Schema.Literal<"mcp_approval">, Schema.Literal<"project_update">, Schema.Literal<"runner">]>;
         readonly id: Schema.String;
     }>>;
     readonly until: Schema.String;
@@ -179,3 +239,4 @@ export declare const renderNotification: (notification: {
     readonly subject: (typeof NotificationSubject)['Type'];
     readonly payload: NotificationPayload;
 }) => RenderedNotification;
+export declare const writtenFromText: (from: NotificationPayload['writtenFrom']) => string;

package/types/packages/core/src/owner.d.ts

@@ -0,0 +1,15 @@
+import * as Schema from 'effect/Schema';
+/** What can move between the Workspace and one of its Teams. */
+export declare const OwnedKind: Schema.Literals<readonly ["repository", "memory", "decision", "secret"]>;
+/** The new owner: a Team, or the Workspace when `team` is null. */
+export declare const OwnerChange: Schema.Struct<{
+    readonly team: Schema.Union<readonly [Schema.String, Schema.Null]>;
+}>;
+export declare const OwnerMoved: Schema.Struct<{
+    readonly kind: Schema.Literals<readonly ["repository", "memory", "decision", "secret"]>;
+    readonly id: Schema.String;
+    readonly team: Schema.Union<readonly [Schema.String, Schema.Null]>;
+}>;
+export type OwnedKind = (typeof OwnedKind)['Type'];
+export type OwnerChange = (typeof OwnerChange)['Type'];
+export type OwnerMoved = (typeof OwnerMoved)['Type'];

package/types/packages/core/src/package-declarations.d.ts

@@ -1,8 +1,8 @@
 import * as Schema from 'effect/Schema';
 import { KitKinds } from './kit';
 import type { JsonObject, JsonValue } from './runtime-type';
-import { type ScheduleRule, type ScheduleMisfirePolicy, type ScheduleOverlapPolicy } from './schedule';
-export declare const LoopCapabilities: readonly ['agent_work', 'ask', 'call', 'verify', 'change_request', 'write_back', 'post_comment', 'create_tasks', 'merge_change_request', 'publish_release'];
+import { ScheduleRule, type ScheduleMisfirePolicy, type ScheduleOverlapPolicy } from './schedule';
+export declare const LoopCapabilities: readonly ['agent_work', 'ask', 'call', 'verify', 'change_request', 'write_back', 'post_comment', 'create_tasks', 'merge_change_request', 'publish_release', 'read_transcripts', 'propose', 'read_project', 'draft_update'];
 declare const JsonObject: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
 /** What the control plane reads from a Loop without running it. */
 export declare const LoopManifest: Schema.Struct<{
@@ -23,15 +23,68 @@ export declare const LoopManifest: Schema.Struct<{
         readonly title: Schema.String;
         readonly loop: Schema.String;
     }>>;
-    readonly capabilities: Schema.$Array<Schema.Literals<readonly ["agent_work", "ask", "call", "verify", "change_request", "write_back", "post_comment", "create_tasks", "merge_change_request", "publish_release"]>>;
+    readonly capabilities: Schema.$Array<Schema.Literals<readonly ["agent_work", "ask", "call", "verify", "change_request", "write_back", "post_comment", "create_tasks", "merge_change_request", "publish_release", "read_transcripts", "propose", "read_project", "draft_update"]>>;
     /** The names of the Secrets the Loop reads. */
     readonly secrets: Schema.optionalKey<Schema.$Array<Schema.String>>;
     /** The hosts the program calls besides Kitman, or `open`. */
     readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
         readonly hosts: Schema.$Array<Schema.String>;
     }>, Schema.Literal<"open">]>>;
+    /** A Schedule a Workspace can turn on for the Loop; it is off until someone does. */
+    readonly schedule: Schema.optionalKey<Schema.Struct<{
+        readonly rule: Schema.Union<readonly [Schema.Struct<{
+            readonly frequency: Schema.Literals<readonly ["daily", "weekly"]>;
+            readonly hour: Schema.Int;
+            readonly minute: Schema.Int;
+            readonly second: Schema.optionalKey<Schema.Int>;
+            readonly daysOfWeek: Schema.optionalKey<Schema.$Array<Schema.Int>>;
+        }>, Schema.Struct<{
+            readonly cron: Schema.String;
+        }>]>;
+        readonly timezone: Schema.String;
+    }>>;
 }>;
 export type LoopManifest = typeof LoopManifest.Type;
+/** A Loop as it resolves where it was asked about, with the Agent each role uses and what starts it. */
+export declare const LoopDetail: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly resolved: Schema.optionalKey<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly title: Schema.String;
+        readonly layer: Schema.Literals<readonly ["team", "workspace", "shipped"]>;
+        readonly digest: Schema.String;
+        readonly outcome: Schema.optionalKey<Schema.String>;
+        readonly offers: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly title: Schema.String;
+            readonly loop: Schema.String;
+        }>>;
+        readonly publishedAt: Schema.String;
+        readonly package: Schema.String;
+        readonly agents: Schema.$Record<Schema.String, Schema.String>;
+        readonly when: Schema.$Array<Schema.Struct<{
+            readonly event: Schema.String;
+            readonly filter: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>>]>>>;
+            readonly input: Schema.$Record<Schema.String, Schema.String>;
+        }>>;
+        /** The Schedule the Loop offers: whether this Workspace turned it on, and when it next runs. */
+        readonly schedule: Schema.optionalKey<Schema.Struct<{
+            readonly rule: Schema.Union<readonly [Schema.Struct<{
+                readonly frequency: Schema.Literals<readonly ["daily", "weekly"]>;
+                readonly hour: Schema.Int;
+                readonly minute: Schema.Int;
+                readonly second: Schema.optionalKey<Schema.Int>;
+                readonly daysOfWeek: Schema.optionalKey<Schema.$Array<Schema.Int>>;
+            }>, Schema.Struct<{
+                readonly cron: Schema.String;
+            }>]>;
+            readonly timezone: Schema.String;
+            readonly on: Schema.Boolean;
+            readonly nextRunAt: Schema.optionalKey<Schema.String>;
+        }>>;
+    }>>;
+}>;
+export type LoopDetail = (typeof LoopDetail)['Type'];
 /** An Agent as a Package declares it, with its instructions already read from the repository. */
 export declare const AgentDeclaration: Schema.Struct<{
     readonly extends: Schema.optionalKey<Schema.String>;
@@ -50,7 +103,7 @@ export type AgentDeclaration = typeof AgentDeclaration.Type;
 export declare const ScheduleDeclaration: Schema.Union<readonly [Schema.Struct<{
     readonly name: Schema.String;
     readonly loop: Schema.String;
-    readonly project: Schema.optionalKey<Schema.String>;
+    readonly team: Schema.optionalKey<Schema.String>;
     readonly input: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
     readonly timezone: Schema.String;
     readonly misfire: Schema.optionalKey<Schema.Literals<readonly ["skip", "fire_once", "catch_up"]>>;
@@ -60,7 +113,7 @@ export declare const ScheduleDeclaration: Schema.Union<readonly [Schema.Struct<{
 }>, Schema.Struct<{
     readonly name: Schema.String;
     readonly loop: Schema.String;
-    readonly project: Schema.optionalKey<Schema.String>;
+    readonly team: Schema.optionalKey<Schema.String>;
     readonly input: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
     readonly timezone: Schema.String;
     readonly misfire: Schema.optionalKey<Schema.Literals<readonly ["skip", "fire_once", "catch_up"]>>;
@@ -91,12 +144,12 @@ export declare const KitInstallationDeclaration: Schema.Struct<{
     readonly version: Schema.optionalKey<Schema.String>;
 }>;
 export type KitInstallationDeclaration = typeof KitInstallationDeclaration.Type;
-/** Where a Kit applies: as Workspace policy, and attached to Projects by slug. */
+/** Where a Kit applies: as Workspace policy, and attached to Teams by slug. */
 export declare const KitAssignmentDeclaration: Schema.Struct<{
     /** An authored Kit's key, or an installed Kit's source slug. */
     readonly kit: Schema.String;
     readonly workspace: Schema.optionalKey<Schema.Literals<readonly ["default", "mandatory"]>>;
-    readonly projects: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly teams: Schema.optionalKey<Schema.$Array<Schema.String>>;
 }>;
 export type KitAssignmentDeclaration = typeof KitAssignmentDeclaration.Type;
 export declare const KitDeclaration: Schema.Union<readonly [Schema.Struct<{
@@ -106,7 +159,7 @@ export declare const KitDeclaration: Schema.Union<readonly [Schema.Struct<{
     /** An authored Kit's key, or an installed Kit's source slug. */
     readonly kit: Schema.String;
     readonly workspace: Schema.optionalKey<Schema.Literals<readonly ["default", "mandatory"]>>;
-    readonly projects: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly teams: Schema.optionalKey<Schema.$Array<Schema.String>>;
 }>, Schema.Struct<{
     readonly name: Schema.String;
     readonly kind: Schema.optionalKey<Schema.Literals<readonly ["technology", "brand", "domain", "process", "other"]>>;
@@ -138,13 +191,26 @@ export declare const PackageDeclarations: Schema.Struct<{
             readonly title: Schema.String;
             readonly loop: Schema.String;
         }>>;
-        readonly capabilities: Schema.$Array<Schema.Literals<readonly ["agent_work", "ask", "call", "verify", "change_request", "write_back", "post_comment", "create_tasks", "merge_change_request", "publish_release"]>>;
+        readonly capabilities: Schema.$Array<Schema.Literals<readonly ["agent_work", "ask", "call", "verify", "change_request", "write_back", "post_comment", "create_tasks", "merge_change_request", "publish_release", "read_transcripts", "propose", "read_project", "draft_update"]>>;
         /** The names of the Secrets the Loop reads. */
         readonly secrets: Schema.optionalKey<Schema.$Array<Schema.String>>;
         /** The hosts the program calls besides Kitman, or `open`. */
         readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
             readonly hosts: Schema.$Array<Schema.String>;
         }>, Schema.Literal<"open">]>>;
+        /** A Schedule a Workspace can turn on for the Loop; it is off until someone does. */
+        readonly schedule: Schema.optionalKey<Schema.Struct<{
+            readonly rule: Schema.Union<readonly [Schema.Struct<{
+                readonly frequency: Schema.Literals<readonly ["daily", "weekly"]>;
+                readonly hour: Schema.Int;
+                readonly minute: Schema.Int;
+                readonly second: Schema.optionalKey<Schema.Int>;
+                readonly daysOfWeek: Schema.optionalKey<Schema.$Array<Schema.Int>>;
+            }>, Schema.Struct<{
+                readonly cron: Schema.String;
+            }>]>;
+            readonly timezone: Schema.String;
+        }>>;
     }>>;
     readonly agents: Schema.$Record<Schema.String, Schema.Struct<{
         readonly extends: Schema.optionalKey<Schema.String>;
@@ -161,7 +227,7 @@ export declare const PackageDeclarations: Schema.Struct<{
     readonly schedules: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Struct<{
         readonly name: Schema.String;
         readonly loop: Schema.String;
-        readonly project: Schema.optionalKey<Schema.String>;
+        readonly team: Schema.optionalKey<Schema.String>;
         readonly input: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
         readonly timezone: Schema.String;
         readonly misfire: Schema.optionalKey<Schema.Literals<readonly ["skip", "fire_once", "catch_up"]>>;
@@ -171,7 +237,7 @@ export declare const PackageDeclarations: Schema.Struct<{
     }>, Schema.Struct<{
         readonly name: Schema.String;
         readonly loop: Schema.String;
-        readonly project: Schema.optionalKey<Schema.String>;
+        readonly team: Schema.optionalKey<Schema.String>;
         readonly input: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
         readonly timezone: Schema.String;
         readonly misfire: Schema.optionalKey<Schema.Literals<readonly ["skip", "fire_once", "catch_up"]>>;
@@ -193,7 +259,7 @@ export declare const PackageDeclarations: Schema.Struct<{
         /** An authored Kit's key, or an installed Kit's source slug. */
         readonly kit: Schema.String;
         readonly workspace: Schema.optionalKey<Schema.Literals<readonly ["default", "mandatory"]>>;
-        readonly projects: Schema.optionalKey<Schema.$Array<Schema.String>>;
+        readonly teams: Schema.optionalKey<Schema.$Array<Schema.String>>;
     }>, Schema.Struct<{
         readonly name: Schema.String;
         readonly kind: Schema.optionalKey<Schema.Literals<readonly ["technology", "brand", "domain", "process", "other"]>>;
@@ -220,7 +286,7 @@ export type PackageRecordChanges = PackageChanges & {
 export type ScheduleRecord = {
     readonly name?: string;
     readonly loop: string;
-    readonly projectId: string;
+    readonly teamId: string;
     readonly input: JsonValue;
     readonly rule: ScheduleRule;
     readonly timezone: string;
@@ -256,12 +322,12 @@ export type KitInstallationRecord = {
     readonly source: string;
     readonly version: string | null;
 };
-/** A Kit's Workspace policy mode and the Projects it is attached to. */
+/** A Kit's Workspace policy mode and the Teams it is attached to. */
 export type KitAssignmentRecord = {
     /** As declared: an authored Kit's key or an installed Kit's source slug. */
     readonly kit: string;
     readonly workspace: 'default' | 'mandatory' | null;
-    readonly projects: readonly string[];
+    readonly teams: readonly string[];
 };
 /** A Kit source the Marketplace offers the Workspace, its versions newest first. */
 export type KitSourceOption = {
@@ -320,12 +386,12 @@ export type PackagePlanConflict = {
     /** The other Package in the layer that declares it. */
     readonly package: string;
 } | {
-    readonly kind: 'not_for_project';
+    readonly kind: 'not_for_team';
     readonly declaration: string;
 } | {
-    readonly kind: 'schedule_project';
+    readonly kind: 'schedule_team';
     readonly key: string;
-    /** `missing` in a Workspace Package, `not_allowed` in a Project Package, `unknown` for no such Project. */
+    /** `missing` in a Workspace Package, `not_allowed` in a Team Package, `unknown` for no such Team. */
     readonly problem: 'missing' | 'not_allowed' | 'unknown';
 } | {
     readonly kind: 'loop_unresolved';
@@ -346,9 +412,9 @@ export type PackagePlanConflict = {
     readonly kind: 'kit_policy_disabled';
     readonly key: string;
 } | {
-    readonly kind: 'kit_project_unknown';
+    readonly kind: 'kit_team_unknown';
     readonly key: string;
-    readonly project: string;
+    readonly team: string;
 };
 /** A Loop or Agent the deploy removes that a record outside the Package still names. */
 export type PackagePlanWarning = {
@@ -371,21 +437,21 @@ export type PackagePlan = {
 };
 /** A Package's layer, and where it puts its Schedules. */
 export type PackagePlanScope = {
-    readonly layer: 'project';
-    readonly projectId: string;
+    readonly layer: 'team';
+    readonly teamId: string;
 } | {
     readonly layer: 'workspace';
-    /** The Workspace's Projects, by slug. */
-    readonly projects: ReadonlyMap<string, string>;
+    /** The Workspace's Teams, by key. */
+    readonly teams: ReadonlyMap<string, string>;
 };
-/** The Project a declared Schedule runs in, or why it has none. */
-export declare const scheduleProject: (declaration: ScheduleDeclaration, scope: PackagePlanScope) => {
-    readonly projectId: string;
+/** The Team a declared Schedule runs in, or why it has none. */
+export declare const scheduleTeam: (declaration: ScheduleDeclaration, scope: PackagePlanScope) => {
+    readonly teamId: string;
 } | {
     readonly problem: 'missing' | 'not_allowed' | 'unknown';
 };
 /** The live Schedule a declaration asks for. */
-export declare const scheduleRecord: (declaration: ScheduleDeclaration, projectId: string) => ScheduleRecord;
+export declare const scheduleRecord: (declaration: ScheduleDeclaration, teamId: string) => ScheduleRecord;
 /** The fields where a record's live value left what was deployed, each with the version that last changed it. */
 export declare const recordDrift: (kind: RecordDrift['kind'], owned: OwnedRecord<JsonObject>) => RecordDrift[];
 /** The live Kit an authored Kit declaration asks for; its key is its slug. */
@@ -394,9 +460,9 @@ export declare const authoredKitRecord: (key: string, declaration: AuthoredKitDe
 export declare const kitInstallationRecord: (declaration: KitInstallationDeclaration, sources: readonly KitSourceOption[]) => KitInstallationRecord | {
     readonly problem: 'unknown' | 'untrusted' | 'version_unknown';
 };
-/** The assignment a declaration asks for, with its Projects' ids, or the first Project slug that names none. */
-export declare const kitAssignmentRecord: (declaration: KitAssignmentDeclaration, projects: ReadonlyMap<string, string>) => KitAssignmentRecord | {
-    readonly unknownProject: string;
+/** The assignment a declaration asks for, with its Teams' ids, or the first Team slug that names none. */
+export declare const kitAssignmentRecord: (declaration: KitAssignmentDeclaration, teams: ReadonlyMap<string, string>) => KitAssignmentRecord | {
+    readonly unknownTeam: string;
 };
 /**
  * Compares a Package's current declarations with new ones. `others` are the other Packages in the same layer,

package/types/packages/core/src/package.d.ts

@@ -2,7 +2,7 @@ import * as Schema from 'effect/Schema';
 /** A Package's name, from its `package.json`. */
 export declare const PackageName: Schema.String;
 export declare const PackageDigest: Schema.String;
-export declare const PackageLayer: Schema.Union<readonly [Schema.Literal<"project">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
+export declare const PackageLayer: Schema.Union<readonly [Schema.Literal<"team">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
 export type PackageLayer = (typeof PackageLayer)['Type'];
 export declare const PackageProvenance: Schema.Struct<{
     readonly repository: Schema.optionalKey<Schema.String>;
@@ -18,8 +18,8 @@ export type PackageBundleUpload = (typeof PackageBundleUpload)['Type'];
 /** A Package already built and its bundle uploaded, to plan. */
 export declare const PackagePlanRequest: Schema.Struct<{
     name: Schema.String;
-    /** The Project layer; without it, the Workspace's. */
-    projectId: Schema.optionalKey<Schema.String>;
+    /** The Team layer; without it, the Workspace's. */
+    teamId: Schema.optionalKey<Schema.String>;
     digest: Schema.String;
     /** As the build read them out: `loops`, `agents`, and any other kind the Package declares. */
     declarations: Schema.$Record<Schema.String, Schema.Unknown>;
@@ -34,7 +34,7 @@ export type PackagePlanRequest = (typeof PackagePlanRequest)['Type'];
 /** Deploys against the version the plan was made from; `null` when the Package has none yet. */
 export declare const PackageDeployRequest: Schema.Struct<{
     readonly name: Schema.String;
-    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly teamId: Schema.optionalKey<Schema.String>;
     readonly digest: Schema.String;
     readonly declarations: Schema.$Record<Schema.String, Schema.Unknown>;
     readonly protocolVersion: Schema.Int;
@@ -82,7 +82,7 @@ export declare const PackageDrift: Schema.Struct<{
 export type PackageDrift = (typeof PackageDrift)['Type'];
 export declare const PackagePlanResult: Schema.Struct<{
     readonly name: Schema.String;
-    readonly layer: Schema.Union<readonly [Schema.Literal<"project">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
+    readonly layer: Schema.Union<readonly [Schema.Literal<"team">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
     readonly currentVersion: Schema.Union<readonly [Schema.Int, Schema.Null]>;
     /** The commit the current version was built from; a deploy must descend from it. */
     readonly currentCommit: Schema.optionalKey<Schema.String>;
@@ -155,10 +155,10 @@ export declare const PackagePlanResult: Schema.Struct<{
         readonly id: Schema.String;
         readonly package: Schema.String;
     }>, Schema.Struct<{
-        readonly kind: Schema.Literal<"not_for_project">;
+        readonly kind: Schema.Literal<"not_for_team">;
         readonly declaration: Schema.String;
     }>, Schema.Struct<{
-        readonly kind: Schema.Literal<"schedule_project">;
+        readonly kind: Schema.Literal<"schedule_team">;
         readonly key: Schema.String;
         readonly problem: Schema.Union<readonly [Schema.Literal<"missing">, Schema.Literal<"not_allowed">, Schema.Literal<"unknown">]>;
     }>, Schema.Struct<{
@@ -179,9 +179,9 @@ export declare const PackagePlanResult: Schema.Struct<{
         readonly kind: Schema.Literal<"kit_policy_disabled">;
         readonly key: Schema.String;
     }>, Schema.Struct<{
-        readonly kind: Schema.Literal<"kit_project_unknown">;
+        readonly kind: Schema.Literal<"kit_team_unknown">;
         readonly key: Schema.String;
-        readonly project: Schema.String;
+        readonly team: Schema.String;
     }>]>>;
     /** Loops and Agents the deploy removes that records outside the Package still name. */
     readonly warnings: Schema.$Array<Schema.Struct<{
@@ -213,8 +213,8 @@ export declare const PackageVersionSummary: Schema.Struct<{
 export type PackageVersionSummary = (typeof PackageVersionSummary)['Type'];
 export declare const PackageSummary: Schema.Struct<{
     name: Schema.String;
-    layer: Schema.Union<readonly [Schema.Literal<"project">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
-    projectId: Schema.optionalKey<Schema.String>;
+    layer: Schema.Union<readonly [Schema.Literal<"team">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
+    teamId: Schema.optionalKey<Schema.String>;
     current: Schema.optionalKey<Schema.Struct<{
         readonly number: Schema.Int;
         readonly digest: Schema.String;
@@ -238,8 +238,8 @@ export type PackageSummary = (typeof PackageSummary)['Type'];
 export declare const PackageList: Schema.Struct<{
     readonly items: Schema.$Array<Schema.Struct<{
         name: Schema.String;
-        layer: Schema.Union<readonly [Schema.Literal<"project">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
-        projectId: Schema.optionalKey<Schema.String>;
+        layer: Schema.Union<readonly [Schema.Literal<"team">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
+        teamId: Schema.optionalKey<Schema.String>;
         current: Schema.optionalKey<Schema.Struct<{
             readonly number: Schema.Int;
             readonly digest: Schema.String;
@@ -264,8 +264,8 @@ export type PackageList = (typeof PackageList)['Type'];
 /** A Package with every version, newest first. */
 export declare const PackageDetail: Schema.Struct<{
     readonly name: Schema.String;
-    readonly layer: Schema.Union<readonly [Schema.Literal<"project">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
-    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly layer: Schema.Union<readonly [Schema.Literal<"team">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
+    readonly teamId: Schema.optionalKey<Schema.String>;
     readonly current: Schema.optionalKey<Schema.Struct<{
         readonly number: Schema.Int;
         readonly digest: Schema.String;
@@ -328,7 +328,7 @@ export declare const PackageDetail: Schema.Struct<{
 }>;
 export type PackageDetail = (typeof PackageDetail)['Type'];
 export declare const PackageScopeQuery: Schema.Struct<{
-    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly teamId: Schema.optionalKey<Schema.String>;
 }>;
 /** A Workspace owner's or admin's trust in one repository branch to deploy one Package to one layer from CI. */
 export declare const DeployBinding: Schema.Struct<{
@@ -338,18 +338,18 @@ export declare const DeployBinding: Schema.Struct<{
     readonly repository: Schema.String;
     readonly branch: Schema.String;
     readonly packageName: Schema.String;
-    readonly layer: Schema.Union<readonly [Schema.Literal<"project">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
-    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly layer: Schema.Union<readonly [Schema.Literal<"team">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
+    readonly teamId: Schema.optionalKey<Schema.String>;
     readonly createdByUserId: Schema.String;
     readonly createdAt: Schema.String;
 }>;
 export type DeployBinding = (typeof DeployBinding)['Type'];
-/** Binds a RepoBinding's branch to a Package in a Project's layer, or the Workspace's without `projectId`. */
+/** Binds a RepoBinding's branch to a Package in a Team's layer, or the Workspace's without `teamId`. */
 export declare const DeployBindingCreate: Schema.Struct<{
     readonly repoBindingId: Schema.String;
     readonly branch: Schema.String;
     readonly packageName: Schema.String;
-    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly teamId: Schema.optionalKey<Schema.String>;
 }>;
 export type DeployBindingCreate = (typeof DeployBindingCreate)['Type'];
 export declare const DeployBindingList: Schema.Struct<{
@@ -360,8 +360,8 @@ export declare const DeployBindingList: Schema.Struct<{
         readonly repository: Schema.String;
         readonly branch: Schema.String;
         readonly packageName: Schema.String;
-        readonly layer: Schema.Union<readonly [Schema.Literal<"project">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
-        readonly projectId: Schema.optionalKey<Schema.String>;
+        readonly layer: Schema.Union<readonly [Schema.Literal<"team">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
+        readonly teamId: Schema.optionalKey<Schema.String>;
         readonly createdByUserId: Schema.String;
         readonly createdAt: Schema.String;
     }>>;