@cat-factory/contracts 0.6.0

package/dist/github.d.ts

@@ -0,0 +1,215 @@
+import * as v from 'valibot';
+/** A repository the integration tracks for a workspace. */
+export declare const githubRepoSchema: v.ObjectSchema<{
+    readonly githubId: v.NumberSchema<undefined>;
+    readonly installationId: v.NumberSchema<undefined>;
+    readonly owner: v.StringSchema<undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly defaultBranch: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly private: v.BooleanSchema<undefined>;
+    /** Optional link to a board block this repo backs. */
+    readonly blockId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /**
+     * Whether this repo is a monorepo hosting more than one service. When true the
+     * board lets several service frames target the same repo, each pinned to its own
+     * subdirectory (carried on the {@link Service}), and that subdirectory is fed to
+     * every agent working on the service. Owned by the board (set explicitly), so —
+     * like `blockId` — sync never overwrites it. Absent/false ⇒ a plain single-service
+     * repo (the historical behaviour).
+     */
+    readonly isMonorepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /** When this projection row was last refreshed (epoch ms). */
+    readonly syncedAt: v.NumberSchema<undefined>;
+}, undefined>;
+export type GitHubRepo = v.InferOutput<typeof githubRepoSchema>;
+export declare const githubBranchSchema: v.ObjectSchema<{
+    readonly repoGithubId: v.NumberSchema<undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly headSha: v.StringSchema<undefined>;
+    readonly protected: v.BooleanSchema<undefined>;
+    readonly syncedAt: v.NumberSchema<undefined>;
+}, undefined>;
+export type GitHubBranch = v.InferOutput<typeof githubBranchSchema>;
+export declare const githubPullRequestStateSchema: v.PicklistSchema<["open", "closed"], undefined>;
+export type GitHubPullRequestState = v.InferOutput<typeof githubPullRequestStateSchema>;
+export declare const githubPullRequestSchema: v.ObjectSchema<{
+    readonly repoGithubId: v.NumberSchema<undefined>;
+    readonly number: v.NumberSchema<undefined>;
+    readonly githubId: v.NumberSchema<undefined>;
+    readonly title: v.StringSchema<undefined>;
+    readonly state: v.PicklistSchema<["open", "closed"], undefined>;
+    readonly headRef: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly baseRef: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly headSha: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly merged: v.BooleanSchema<undefined>;
+    readonly author: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** GitHub's `updated_at` (epoch ms), used as the incremental sync cursor. */
+    readonly updatedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    readonly syncedAt: v.NumberSchema<undefined>;
+}, undefined>;
+export type GitHubPullRequest = v.InferOutput<typeof githubPullRequestSchema>;
+export declare const githubIssueStateSchema: v.PicklistSchema<["open", "closed"], undefined>;
+export type GitHubIssueState = v.InferOutput<typeof githubIssueStateSchema>;
+export declare const githubIssueSchema: v.ObjectSchema<{
+    readonly repoGithubId: v.NumberSchema<undefined>;
+    readonly number: v.NumberSchema<undefined>;
+    readonly githubId: v.NumberSchema<undefined>;
+    readonly title: v.StringSchema<undefined>;
+    readonly state: v.PicklistSchema<["open", "closed"], undefined>;
+    readonly author: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly labels: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    readonly updatedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    readonly syncedAt: v.NumberSchema<undefined>;
+}, undefined>;
+export type GitHubIssue = v.InferOutput<typeof githubIssueSchema>;
+export declare const githubCommitSchema: v.ObjectSchema<{
+    readonly repoGithubId: v.NumberSchema<undefined>;
+    readonly sha: v.StringSchema<undefined>;
+    readonly message: v.StringSchema<undefined>;
+    readonly author: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly authoredAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    readonly syncedAt: v.NumberSchema<undefined>;
+}, undefined>;
+export type GitHubCommit = v.InferOutput<typeof githubCommitSchema>;
+export declare const githubCheckRunSchema: v.ObjectSchema<{
+    readonly repoGithubId: v.NumberSchema<undefined>;
+    readonly githubId: v.NumberSchema<undefined>;
+    readonly headSha: v.StringSchema<undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly status: v.StringSchema<undefined>;
+    readonly conclusion: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly syncedAt: v.NumberSchema<undefined>;
+}, undefined>;
+export type GitHubCheckRun = v.InferOutput<typeof githubCheckRunSchema>;
+/** A workspace's GitHub App installation, as exposed to clients (no token). */
+export declare const githubConnectionSchema: v.ObjectSchema<{
+    readonly installationId: v.NumberSchema<undefined>;
+    readonly accountLogin: v.StringSchema<undefined>;
+    readonly targetType: v.PicklistSchema<["Organization", "User"], undefined>;
+    readonly connectedAt: v.NumberSchema<undefined>;
+    /**
+     * Whether cat-factory can create repositories under this account itself — true
+     * only for accounts served by the privileged App tier (ADR 0005). When false,
+     * the UI keeps the manual "create on GitHub" flow.
+     */
+    readonly canCreateRepos: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    /**
+     * Whether the installation actually granted the App `workflows: write`. When
+     * false, pushes that add/update `.github/workflows/*` are rejected by GitHub, so
+     * the UI warns the user to grant the permission. Read from the token's granted
+     * set (App ∩ install approval); defaults to false for older backends.
+     */
+    readonly canManageWorkflows: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+}, undefined>;
+export type GitHubConnection = v.InferOutput<typeof githubConnectionSchema>;
+/**
+ * A discoverable GitHub App installation (one account where the App is installed),
+ * listed via the app JWT so the connect UI can offer a pick instead of a manually
+ * typed installation id. `connected` says whether it's already bound: to THIS
+ * workspace, to ANOTHER one (so connecting would be rejected), or to NONE.
+ */
+export declare const githubInstallationOptionSchema: v.ObjectSchema<{
+    readonly installationId: v.NumberSchema<undefined>;
+    readonly accountLogin: v.StringSchema<undefined>;
+    readonly targetType: v.PicklistSchema<["Organization", "User"], undefined>;
+    readonly accountAvatarUrl: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly connected: v.PicklistSchema<["this", "other", "none"], undefined>;
+}, undefined>;
+export type GitHubInstallationOption = v.InferOutput<typeof githubInstallationOptionSchema>;
+/**
+ * A repository the connected installation can access, annotated with whether the
+ * current workspace explicitly links it. Repos are linked per workspace (the
+ * installation is shared across an account's workspaces, but each board chooses
+ * its own repos), so the connect UI lists these and the user picks a subset.
+ */
+export declare const githubAvailableRepoSchema: v.ObjectSchema<{
+    readonly githubId: v.NumberSchema<undefined>;
+    readonly owner: v.StringSchema<undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly defaultBranch: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly private: v.BooleanSchema<undefined>;
+    /** Whether this repo is currently linked to (tracked by) this workspace. */
+    readonly linked: v.BooleanSchema<undefined>;
+    /** Whether the (linked) repo is flagged as a monorepo. False for unlinked repos. */
+    readonly isMonorepo: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+}, undefined>;
+export type GitHubAvailableRepo = v.InferOutput<typeof githubAvailableRepoSchema>;
+/**
+ * Create a repository under the connected account (privileged App tier, ADR
+ * 0005). `name` is a single GitHub name segment — no `owner/` prefix — matching
+ * the bootstrap repo-name rule; the owner is the connected installation account.
+ */
+export declare const createRepoRequestSchema: v.ObjectSchema<{
+    readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.RegexAction<string, "Only letters, digits, '.', '_' and '-' are allowed">, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>;
+    readonly private: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+    readonly description: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 350, undefined>]>, "">;
+}, undefined>;
+export type CreateRepoRequest = v.InferOutput<typeof createRepoRequestSchema>;
+/** Set the exact set of repos (by GitHub numeric id) this workspace links. */
+export declare const linkReposSchema: v.ObjectSchema<{
+    readonly repoGithubIds: v.ArraySchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>;
+export type LinkReposInput = v.InferOutput<typeof linkReposSchema>;
+/** Mark (or unmark) a linked repo as a monorepo hosting several services. */
+export declare const setRepoMonorepoSchema: v.ObjectSchema<{
+    readonly isMonorepo: v.BooleanSchema<undefined>;
+}, undefined>;
+export type SetRepoMonorepoInput = v.InferOutput<typeof setRepoMonorepoSchema>;
+/**
+ * One directory entry of a repo's tree, used by the monorepo service picker to let
+ * a user browse a repo and pin a service to its subdirectory. Mirrors the slice of
+ * GitHub's contents API the picker needs (it lists a single level at a time).
+ */
+export declare const repoTreeEntrySchema: v.ObjectSchema<{
+    /** Path relative to the repo root, e.g. `packages/api`. */
+    readonly path: v.StringSchema<undefined>;
+    /** Base name, e.g. `api`. */
+    readonly name: v.StringSchema<undefined>;
+    /** `file` | `dir` | `symlink` | `submodule`. */
+    readonly type: v.StringSchema<undefined>;
+}, undefined>;
+export type RepoTreeEntry = v.InferOutput<typeof repoTreeEntrySchema>;
+/** Trigger a resync. Defaults to an incremental resync of all tracked repos. */
+export declare const resyncRequestSchema: v.ObjectSchema<{
+    /** Limit the resync to a single repo (by its GitHub numeric id). */
+    readonly repoGithubId: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    /** Run a full backfill (durable Workflow) instead of an incremental pass. */
+    readonly full: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+}, undefined>;
+export type ResyncRequest = v.InferOutput<typeof resyncRequestSchema>;
+export declare const createBranchSchema: v.ObjectSchema<{
+    readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly fromSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+}, undefined>;
+export type CreateBranchInput = v.InferOutput<typeof createBranchSchema>;
+export declare const commitFilesSchema: v.ObjectSchema<{
+    readonly branch: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly message: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly files: v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
+        readonly path: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly content: v.StringSchema<undefined>;
+    }, undefined>, undefined>, v.MinLengthAction<{
+        path: string;
+        content: string;
+    }[], 1, undefined>]>;
+    /** Parent commit to build on; defaults to the branch tip. */
+    readonly baseSha: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type CommitFilesInput = v.InferOutput<typeof commitFilesSchema>;
+export declare const openPullRequestSchema: v.ObjectSchema<{
+    readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly head: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly base: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly body: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly draft: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+}, undefined>;
+export type OpenPullRequestInput = v.InferOutput<typeof openPullRequestSchema>;
+export declare const mergePullRequestSchema: v.ObjectSchema<{
+    readonly method: v.OptionalSchema<v.PicklistSchema<["merge", "squash", "rebase"], undefined>, undefined>;
+}, undefined>;
+export type MergePullRequestInput = v.InferOutput<typeof mergePullRequestSchema>;
+export declare const commentSchema: v.ObjectSchema<{
+    readonly body: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+}, undefined>;
+export type CommentInput = v.InferOutput<typeof commentSchema>;
+//# sourceMappingURL=github.d.ts.map

package/dist/github.d.ts.map

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

package/dist/github.js

@@ -0,0 +1,204 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// GitHub integration wire contracts. These describe the *projected* GitHub data
+// cat-factory caches locally (repos/branches, pull requests/issues,
+// commits/check-runs) and serves from D1, plus the request bodies for the
+// connect, resync and write endpoints. As with the board entities, the worker's
+// `GitHubClient` produces these shapes and the core derives its domain types
+// from them, so the API, core and frontend share one vocabulary.
+//
+// Storage-only bookkeeping (the workspace that owns a row, soft-delete
+// tombstones, the cached installation token) is deliberately NOT on the wire —
+// it lives in the core ports / D1 layer.
+// ---------------------------------------------------------------------------
+/** A repository the integration tracks for a workspace. */
+export const githubRepoSchema = v.object({
+    githubId: v.number(),
+    installationId: v.number(),
+    owner: v.string(),
+    name: v.string(),
+    defaultBranch: v.nullable(v.string()),
+    private: v.boolean(),
+    /** Optional link to a board block this repo backs. */
+    blockId: v.nullable(v.string()),
+    /**
+     * Whether this repo is a monorepo hosting more than one service. When true the
+     * board lets several service frames target the same repo, each pinned to its own
+     * subdirectory (carried on the {@link Service}), and that subdirectory is fed to
+     * every agent working on the service. Owned by the board (set explicitly), so —
+     * like `blockId` — sync never overwrites it. Absent/false ⇒ a plain single-service
+     * repo (the historical behaviour).
+     */
+    isMonorepo: v.optional(v.boolean()),
+    /** When this projection row was last refreshed (epoch ms). */
+    syncedAt: v.number(),
+});
+export const githubBranchSchema = v.object({
+    repoGithubId: v.number(),
+    name: v.string(),
+    headSha: v.string(),
+    protected: v.boolean(),
+    syncedAt: v.number(),
+});
+export const githubPullRequestStateSchema = v.picklist(['open', 'closed']);
+export const githubPullRequestSchema = v.object({
+    repoGithubId: v.number(),
+    number: v.number(),
+    githubId: v.number(),
+    title: v.string(),
+    state: githubPullRequestStateSchema,
+    headRef: v.nullable(v.string()),
+    baseRef: v.nullable(v.string()),
+    headSha: v.nullable(v.string()),
+    merged: v.boolean(),
+    author: v.nullable(v.string()),
+    /** GitHub's `updated_at` (epoch ms), used as the incremental sync cursor. */
+    updatedAt: v.nullable(v.number()),
+    syncedAt: v.number(),
+});
+export const githubIssueStateSchema = v.picklist(['open', 'closed']);
+export const githubIssueSchema = v.object({
+    repoGithubId: v.number(),
+    number: v.number(),
+    githubId: v.number(),
+    title: v.string(),
+    state: githubIssueStateSchema,
+    author: v.nullable(v.string()),
+    labels: v.array(v.string()),
+    updatedAt: v.nullable(v.number()),
+    syncedAt: v.number(),
+});
+export const githubCommitSchema = v.object({
+    repoGithubId: v.number(),
+    sha: v.string(),
+    message: v.string(),
+    author: v.nullable(v.string()),
+    authoredAt: v.nullable(v.number()),
+    syncedAt: v.number(),
+});
+export const githubCheckRunSchema = v.object({
+    repoGithubId: v.number(),
+    githubId: v.number(),
+    headSha: v.string(),
+    name: v.string(),
+    status: v.string(),
+    conclusion: v.nullable(v.string()),
+    syncedAt: v.number(),
+});
+/** A workspace's GitHub App installation, as exposed to clients (no token). */
+export const githubConnectionSchema = v.object({
+    installationId: v.number(),
+    accountLogin: v.string(),
+    targetType: v.picklist(['Organization', 'User']),
+    connectedAt: v.number(),
+    /**
+     * Whether cat-factory can create repositories under this account itself — true
+     * only for accounts served by the privileged App tier (ADR 0005). When false,
+     * the UI keeps the manual "create on GitHub" flow.
+     */
+    canCreateRepos: v.optional(v.boolean(), false),
+    /**
+     * Whether the installation actually granted the App `workflows: write`. When
+     * false, pushes that add/update `.github/workflows/*` are rejected by GitHub, so
+     * the UI warns the user to grant the permission. Read from the token's granted
+     * set (App ∩ install approval); defaults to false for older backends.
+     */
+    canManageWorkflows: v.optional(v.boolean(), false),
+});
+/**
+ * A discoverable GitHub App installation (one account where the App is installed),
+ * listed via the app JWT so the connect UI can offer a pick instead of a manually
+ * typed installation id. `connected` says whether it's already bound: to THIS
+ * workspace, to ANOTHER one (so connecting would be rejected), or to NONE.
+ */
+export const githubInstallationOptionSchema = v.object({
+    installationId: v.number(),
+    accountLogin: v.string(),
+    targetType: v.picklist(['Organization', 'User']),
+    accountAvatarUrl: v.nullable(v.string()),
+    connected: v.picklist(['this', 'other', 'none']),
+});
+/**
+ * A repository the connected installation can access, annotated with whether the
+ * current workspace explicitly links it. Repos are linked per workspace (the
+ * installation is shared across an account's workspaces, but each board chooses
+ * its own repos), so the connect UI lists these and the user picks a subset.
+ */
+export const githubAvailableRepoSchema = v.object({
+    githubId: v.number(),
+    owner: v.string(),
+    name: v.string(),
+    defaultBranch: v.nullable(v.string()),
+    private: v.boolean(),
+    /** Whether this repo is currently linked to (tracked by) this workspace. */
+    linked: v.boolean(),
+    /** Whether the (linked) repo is flagged as a monorepo. False for unlinked repos. */
+    isMonorepo: v.optional(v.boolean(), false),
+});
+// ---- Request bodies -------------------------------------------------------
+/**
+ * Create a repository under the connected account (privileged App tier, ADR
+ * 0005). `name` is a single GitHub name segment — no `owner/` prefix — matching
+ * the bootstrap repo-name rule; the owner is the connected installation account.
+ */
+export const createRepoRequestSchema = v.object({
+    name: v.pipe(v.string(), v.trim(), v.regex(/^[A-Za-z0-9_.-]+$/, "Only letters, digits, '.', '_' and '-' are allowed"), v.minLength(1), v.maxLength(100)),
+    private: v.optional(v.boolean(), true),
+    description: v.optional(v.pipe(v.string(), v.maxLength(350)), ''),
+});
+/** Set the exact set of repos (by GitHub numeric id) this workspace links. */
+export const linkReposSchema = v.object({
+    repoGithubIds: v.array(v.number()),
+});
+/** Mark (or unmark) a linked repo as a monorepo hosting several services. */
+export const setRepoMonorepoSchema = v.object({
+    isMonorepo: v.boolean(),
+});
+/**
+ * One directory entry of a repo's tree, used by the monorepo service picker to let
+ * a user browse a repo and pin a service to its subdirectory. Mirrors the slice of
+ * GitHub's contents API the picker needs (it lists a single level at a time).
+ */
+export const repoTreeEntrySchema = v.object({
+    /** Path relative to the repo root, e.g. `packages/api`. */
+    path: v.string(),
+    /** Base name, e.g. `api`. */
+    name: v.string(),
+    /** `file` | `dir` | `symlink` | `submodule`. */
+    type: v.string(),
+});
+/** Trigger a resync. Defaults to an incremental resync of all tracked repos. */
+export const resyncRequestSchema = v.object({
+    /** Limit the resync to a single repo (by its GitHub numeric id). */
+    repoGithubId: v.optional(v.number()),
+    /** Run a full backfill (durable Workflow) instead of an incremental pass. */
+    full: v.optional(v.boolean()),
+});
+export const createBranchSchema = v.object({
+    name: v.pipe(v.string(), v.minLength(1)),
+    fromSha: v.pipe(v.string(), v.minLength(1)),
+});
+export const commitFilesSchema = v.object({
+    branch: v.pipe(v.string(), v.minLength(1)),
+    message: v.pipe(v.string(), v.minLength(1)),
+    files: v.pipe(v.array(v.object({
+        path: v.pipe(v.string(), v.minLength(1)),
+        content: v.string(),
+    })), v.minLength(1)),
+    /** Parent commit to build on; defaults to the branch tip. */
+    baseSha: v.optional(v.string()),
+});
+export const openPullRequestSchema = v.object({
+    title: v.pipe(v.string(), v.minLength(1)),
+    head: v.pipe(v.string(), v.minLength(1)),
+    base: v.pipe(v.string(), v.minLength(1)),
+    body: v.optional(v.string()),
+    draft: v.optional(v.boolean()),
+});
+export const mergePullRequestSchema = v.object({
+    method: v.optional(v.picklist(['merge', 'squash', 'rebase'])),
+});
+export const commentSchema = v.object({
+    body: v.pipe(v.string(), v.minLength(1)),
+});
+//# sourceMappingURL=github.js.map

package/dist/github.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+export * from './primitives.js';
+export * from './entities.js';
+export * from './services.js';
+export * from './fragment-library.js';
+export * from './accounts.js';
+export * from './auth.js';
+export * from './events.js';
+export * from './requests.js';
+export * from './github.js';
+export * from './documents.js';
+export * from './tasks.js';
+export * from './environments.js';
+export * from './runners.js';
+export * from './bootstrap.js';
+export * from './snapshot.js';
+export * from './board-scan.js';
+export * from './iteration-cap.js';
+export * from './requirements.js';
+export * from './clarity.js';
+export * from './spec.js';
+export * from './companion.js';
+export * from './merge.js';
+export * from './consensus.js';
+export * from './release.js';
+export * from './agent-config.js';
+export * from './testing.js';
+export * from './provisioning.js';
+export * from './model-defaults.js';
+export * from './service-fragment-defaults.js';
+export * from './notifications.js';
+export * from './slack.js';
+export * from './observability.js';
+export * from './recurring.js';
+export * from './tracker.js';
+export * from './vendor-credentials.js';
+export * from './api-keys.js';
+export * from './personal-subscriptions.js';
+export * from './localModels.js';
+export * from './sandbox.js';
+export * from './workspace-settings.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,eAAe,CAAA;AAC7B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA"}

package/dist/index.js

@@ -0,0 +1,41 @@
+export * from './primitives.js';
+export * from './entities.js';
+export * from './services.js';
+export * from './fragment-library.js';
+export * from './accounts.js';
+export * from './auth.js';
+export * from './events.js';
+export * from './requests.js';
+export * from './github.js';
+export * from './documents.js';
+export * from './tasks.js';
+export * from './environments.js';
+export * from './runners.js';
+export * from './bootstrap.js';
+export * from './snapshot.js';
+export * from './board-scan.js';
+export * from './iteration-cap.js';
+export * from './requirements.js';
+export * from './clarity.js';
+export * from './spec.js';
+export * from './companion.js';
+export * from './merge.js';
+export * from './consensus.js';
+export * from './release.js';
+export * from './agent-config.js';
+export * from './testing.js';
+export * from './provisioning.js';
+export * from './model-defaults.js';
+export * from './service-fragment-defaults.js';
+export * from './notifications.js';
+export * from './slack.js';
+export * from './observability.js';
+export * from './recurring.js';
+export * from './tracker.js';
+export * from './vendor-credentials.js';
+export * from './api-keys.js';
+export * from './personal-subscriptions.js';
+export * from './localModels.js';
+export * from './sandbox.js';
+export * from './workspace-settings.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,eAAe,CAAA;AAC7B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA"}

package/dist/iteration-cap.d.ts

@@ -0,0 +1,17 @@
+import * as v from 'valibot';
+/**
+ * How a human resolves an iterative gate that hit its budget with the bar still
+ * unmet:
+ * - `extra-round`: grant one more agent pass (bumps the budget by one).
+ * - `proceed`: advance the pipeline accepting the latest output as-is.
+ * - `stop-reset`: cancel the run and return the task to phase zero (editable),
+ *   keeping the latest produced artifact as a reference to rework from.
+ */
+export declare const iterationCapChoiceSchema: v.PicklistSchema<["extra-round", "proceed", "stop-reset"], undefined>;
+export type IterationCapChoice = v.InferOutput<typeof iterationCapChoiceSchema>;
+/** Request body carrying an {@link iterationCapChoiceSchema} choice. */
+export declare const resolveIterationCapSchema: v.ObjectSchema<{
+    readonly choice: v.PicklistSchema<["extra-round", "proceed", "stop-reset"], undefined>;
+}, undefined>;
+export type ResolveIterationCapInput = v.InferOutput<typeof resolveIterationCapSchema>;
+//# sourceMappingURL=iteration-cap.d.ts.map

package/dist/iteration-cap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iteration-cap.d.ts","sourceRoot":"","sources":["../src/iteration-cap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAa5B;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,uEAAuD,CAAA;AAC5F,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E,wEAAwE;AACxE,eAAO,MAAM,yBAAyB;;aAEpC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAA"}

package/dist/iteration-cap.js

@@ -0,0 +1,25 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Shared contract for an iterative agent gate that hit its budget. Two engine
+// gates loop an agent + a human until the agent converges: the requirements
+// reviewer (bounded by `maxRequirementIterations`) and the quality companions
+// (reviewer / spec-companion / architect-companion, bounded by their automatic
+// rework budget). When either spends its budget with the bar still unmet, it
+// parks for a human instead of getting stuck, offering the SAME three choices.
+// This module is the single source of truth for those choices so both gates
+// (and both runtime facades) can't drift.
+// ---------------------------------------------------------------------------
+/**
+ * How a human resolves an iterative gate that hit its budget with the bar still
+ * unmet:
+ * - `extra-round`: grant one more agent pass (bumps the budget by one).
+ * - `proceed`: advance the pipeline accepting the latest output as-is.
+ * - `stop-reset`: cancel the run and return the task to phase zero (editable),
+ *   keeping the latest produced artifact as a reference to rework from.
+ */
+export const iterationCapChoiceSchema = v.picklist(['extra-round', 'proceed', 'stop-reset']);
+/** Request body carrying an {@link iterationCapChoiceSchema} choice. */
+export const resolveIterationCapSchema = v.object({
+    choice: iterationCapChoiceSchema,
+});
+//# sourceMappingURL=iteration-cap.js.map

package/dist/iteration-cap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iteration-cap.js","sourceRoot":"","sources":["../src/iteration-cap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,8EAA8E;AAC9E,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAC/E,4EAA4E;AAC5E,0CAA0C;AAC1C,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAA;AAG5F,wEAAwE;AACxE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,wBAAwB;CACjC,CAAC,CAAA"}

package/dist/localModels.d.ts

@@ -0,0 +1,54 @@
+import * as v from 'valibot';
+/** The supported local runner types. The runner type IS the `ModelRef.provider`. */
+export declare const LOCAL_RUNNERS: readonly ['ollama', 'lmstudio', 'llamacpp', 'vllm', 'custom'];
+export declare const localRunnerSchema: v.PicklistSchema<readonly ["ollama", "lmstudio", "llamacpp", "vllm", "custom"], undefined>;
+export type LocalRunner = v.InferOutput<typeof localRunnerSchema>;
+/** Whether a provider id is one of the local runner types. */
+export declare function isLocalRunner(provider: string): boolean;
+/** Default base URL per runner, for UI prefill. `custom` has none (user supplies it). */
+export declare const LOCAL_RUNNER_DEFAULTS: Record<LocalRunner, string | null>;
+/** Short display label per runner, shown in the picker as the provider label. */
+export declare const LOCAL_RUNNER_LABELS: Record<LocalRunner, string>;
+/**
+ * A user's configured local runner endpoint, as returned to the SPA. The API key is
+ * write-only (never returned); `hasApiKey` reports whether one is stored.
+ */
+export declare const localModelEndpointSchema: v.ObjectSchema<{
+    readonly provider: v.PicklistSchema<readonly ["ollama", "lmstudio", "llamacpp", "vllm", "custom"], undefined>;
+    readonly label: v.StringSchema<undefined>;
+    readonly baseUrl: v.StringSchema<undefined>;
+    /** Whether a (write-only) API key is stored for this endpoint. */
+    readonly hasApiKey: v.BooleanSchema<undefined>;
+    /** The model ids the user has enabled from this runner (surfaced in the picker). */
+    readonly models: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    readonly createdAt: v.NumberSchema<undefined>;
+    readonly updatedAt: v.NumberSchema<undefined>;
+}, undefined>;
+export type LocalModelEndpoint = v.InferOutput<typeof localModelEndpointSchema>;
+/** Create or replace the signed-in user's endpoint for a runner (one per runner). */
+export declare const upsertLocalModelEndpointSchema: v.ObjectSchema<{
+    readonly provider: v.PicklistSchema<readonly ["ollama", "lmstudio", "llamacpp", "vllm", "custom"], undefined>;
+    readonly label: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 60, undefined>]>, undefined>;
+    readonly baseUrl: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 300, undefined>, v.UrlAction<string, undefined>]>;
+    /** Optional bearer key (most local runners ignore it); stored encrypted at rest. */
+    readonly apiKey: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>;
+    readonly models: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
+}, undefined>;
+export type UpsertLocalModelEndpointInput = v.InferOutput<typeof upsertLocalModelEndpointSchema>;
+/** Probe a runner endpoint for reachability + the models it currently serves. */
+export declare const testLocalModelEndpointSchema: v.ObjectSchema<{
+    readonly provider: v.PicklistSchema<readonly ["ollama", "lmstudio", "llamacpp", "vllm", "custom"], undefined>;
+    readonly baseUrl: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 300, undefined>, v.UrlAction<string, undefined>]>;
+    readonly apiKey: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>;
+}, undefined>;
+export type TestLocalModelEndpointInput = v.InferOutput<typeof testLocalModelEndpointSchema>;
+/** The result of probing a runner endpoint's `/models`. */
+export declare const localModelEndpointTestResultSchema: v.ObjectSchema<{
+    readonly reachable: v.BooleanSchema<undefined>;
+    /** Model ids the runner reports (empty when unreachable). */
+    readonly models: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    /** Human-readable failure reason when `reachable` is false. */
+    readonly error: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type LocalModelEndpointTestResult = v.InferOutput<typeof localModelEndpointTestResultSchema>;
+//# sourceMappingURL=localModels.d.ts.map