@cat-factory/contracts 0.6.0

package/dist/documents.d.ts

@@ -0,0 +1,197 @@
+import * as v from 'valibot';
+/** The external document sources cat-factory can link to. */
+export declare const documentSourceKindSchema: v.PicklistSchema<["confluence", "notion", "github"], undefined>;
+export type DocumentSourceKind = v.InferOutput<typeof documentSourceKindSchema>;
+/** One credential a provider needs to connect (rendered as a form field). */
+export declare const credentialFieldSchema: v.ObjectSchema<{
+    /** Stable key stored in the credential bag (e.g. `apiToken`). */
+    readonly key: v.StringSchema<undefined>;
+    /** Human label for the form field. */
+    readonly label: v.StringSchema<undefined>;
+    /** Optional helper text shown under the field. */
+    readonly help: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Optional input placeholder. */
+    readonly placeholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Render as a password input and never echo the value back. */
+    readonly secret: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+}, undefined>;
+export type CredentialField = v.InferOutput<typeof credentialFieldSchema>;
+/**
+ * Everything the frontend needs to render a source's connect form and import
+ * box without hard-coding any provider specifics.
+ */
+export declare const documentSourceDescriptorSchema: v.ObjectSchema<{
+    readonly source: v.PicklistSchema<["confluence", "notion", "github"], undefined>;
+    /** Display name, e.g. `Confluence`. */
+    readonly label: v.StringSchema<undefined>;
+    /** Lucide icon name for the source. */
+    readonly icon: v.StringSchema<undefined>;
+    /** Credentials required to connect, in display order. */
+    readonly credentialFields: v.ArraySchema<v.ObjectSchema<{
+        /** Stable key stored in the credential bag (e.g. `apiToken`). */
+        readonly key: v.StringSchema<undefined>;
+        /** Human label for the form field. */
+        readonly label: v.StringSchema<undefined>;
+        /** Optional helper text shown under the field. */
+        readonly help: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** Optional input placeholder. */
+        readonly placeholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** Render as a password input and never echo the value back. */
+        readonly secret: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+    /** Label for the "import a page" input. */
+    readonly refLabel: v.StringSchema<undefined>;
+    /** Placeholder for the "import a page" input. */
+    readonly refPlaceholder: v.StringSchema<undefined>;
+    /**
+     * Whether this source supports searching its catalogue by title/content (so
+     * the UI offers a search box, not just a paste-a-URL field). Optional for
+     * backward-compatibility; absent is treated as `false`.
+     */
+    readonly searchable: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+}, undefined>;
+export type DocumentSourceDescriptor = v.InferOutput<typeof documentSourceDescriptorSchema>;
+/** A workspace's connection to a document source, as exposed to clients (never the credentials). */
+export declare const documentConnectionSchema: v.ObjectSchema<{
+    readonly source: v.PicklistSchema<["confluence", "notion", "github"], undefined>;
+    /** A human-friendly label for what we're connected to (site URL, workspace name). */
+    readonly label: v.StringSchema<undefined>;
+    /** When the connection was established (epoch ms). */
+    readonly connectedAt: v.NumberSchema<undefined>;
+}, undefined>;
+export type DocumentConnection = v.InferOutput<typeof documentConnectionSchema>;
+/** A page imported from a source, projected locally. */
+export declare const sourceDocumentSchema: v.ObjectSchema<{
+    readonly source: v.PicklistSchema<["confluence", "notion", "github"], undefined>;
+    /** The source's stable id for the page (Confluence page id, Notion page id). */
+    readonly externalId: v.StringSchema<undefined>;
+    readonly title: v.StringSchema<undefined>;
+    /** Canonical URL of the page on the source. */
+    readonly url: v.StringSchema<undefined>;
+    /** A short plain-text excerpt of the body (full body stays in storage). */
+    readonly excerpt: v.StringSchema<undefined>;
+    /** The board block this document is attached to as context, if any. */
+    readonly linkedBlockId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** When this projection row was last refreshed (epoch ms). */
+    readonly syncedAt: v.NumberSchema<undefined>;
+}, undefined>;
+export type SourceDocument = v.InferOutput<typeof sourceDocumentSchema>;
+/**
+ * A single hit from searching a source's catalogue. A lean shape (no body) used
+ * to populate a picker: selecting one imports it (by `externalId`) and links it
+ * to a block. Distinct from {@link SourceDocument} — a hit is not yet projected
+ * locally, so it carries no `linkedBlockId`/`syncedAt`.
+ */
+export declare const documentSearchResultSchema: v.ObjectSchema<{
+    readonly source: v.PicklistSchema<["confluence", "notion", "github"], undefined>;
+    /** The source's stable id for the page (re-usable as an import ref). */
+    readonly externalId: v.StringSchema<undefined>;
+    readonly title: v.StringSchema<undefined>;
+    /** Canonical URL of the page on the source. */
+    readonly url: v.StringSchema<undefined>;
+    /** A short plain-text excerpt for the result row (may be empty). */
+    readonly excerpt: v.StringSchema<undefined>;
+}, undefined>;
+export type DocumentSearchResult = v.InferOutput<typeof documentSearchResultSchema>;
+/** A proposed task within a planned frame/module. */
+export declare const planTaskSchema: v.ObjectSchema<{
+    readonly title: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type PlanTask = v.InferOutput<typeof planTaskSchema>;
+/** A proposed module grouping tasks within a planned frame. */
+export declare const planModuleSchema: v.ObjectSchema<{
+    readonly name: v.StringSchema<undefined>;
+    readonly tasks: v.ArraySchema<v.ObjectSchema<{
+        readonly title: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type PlanModule = v.InferOutput<typeof planModuleSchema>;
+/** A proposed top-level frame (service/api/…) with its modules and loose tasks. */
+export declare const planFrameSchema: v.ObjectSchema<{
+    readonly type: v.PicklistSchema<["frontend", "service", "api", "database", "queue", "integration", "external", "environment"], undefined>;
+    readonly title: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly modules: v.ArraySchema<v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly tasks: v.ArraySchema<v.ObjectSchema<{
+            readonly title: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly tasks: v.ArraySchema<v.ObjectSchema<{
+        readonly title: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type PlanFrame = v.InferOutput<typeof planFrameSchema>;
+/**
+ * A proposed board structure extracted from an imported document. `planner`
+ * records whether an LLM produced it or the deterministic heading parser did, so
+ * the UI can label a preview honestly.
+ */
+export declare const documentBoardPlanSchema: v.ObjectSchema<{
+    readonly source: v.PicklistSchema<["confluence", "notion", "github"], undefined>;
+    readonly externalId: v.StringSchema<undefined>;
+    readonly planner: v.PicklistSchema<["llm", "headings"], undefined>;
+    readonly frames: v.ArraySchema<v.ObjectSchema<{
+        readonly type: v.PicklistSchema<["frontend", "service", "api", "database", "queue", "integration", "external", "environment"], undefined>;
+        readonly title: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly modules: v.ArraySchema<v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly tasks: v.ArraySchema<v.ObjectSchema<{
+                readonly title: v.StringSchema<undefined>;
+                readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly tasks: v.ArraySchema<v.ObjectSchema<{
+            readonly title: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type DocumentBoardPlan = v.InferOutput<typeof documentBoardPlanSchema>;
+/**
+ * Connect a workspace to a document source. The `credentials` bag is validated
+ * by the target provider (the `:source` is in the path), keeping the wire shape
+ * uniform across providers.
+ */
+export declare const connectDocumentSourceSchema: v.ObjectSchema<{
+    readonly credentials: v.RecordSchema<v.StringSchema<undefined>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+}, undefined>;
+export type ConnectDocumentSourceInput = v.InferOutput<typeof connectDocumentSourceSchema>;
+/** Import (fetch + persist) a page by its id or a full page URL. */
+export declare const importDocumentSchema: v.ObjectSchema<{
+    readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 500, undefined>]>;
+}, undefined>;
+export type ImportDocumentInput = v.InferOutput<typeof importDocumentSchema>;
+/** Search a source's catalogue by free text (title/content). */
+export declare const searchDocumentsSchema: v.ObjectSchema<{
+    readonly query: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
+}, undefined>;
+export type SearchDocumentsInput = v.InferOutput<typeof searchDocumentsSchema>;
+/** Preview the board structure a page would expand into (no writes). */
+export declare const planDocumentSchema: v.ObjectSchema<{
+    readonly externalId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
+}, undefined>;
+export type PlanDocumentInput = v.InferOutput<typeof planDocumentSchema>;
+/**
+ * Apply a previously-imported page's structure to the board. Without `frameId`
+ * the plan's frames are spawned at the board root; with it, the plan's modules
+ * and tasks are spawned inside that existing frame.
+ */
+export declare const spawnDocumentSchema: v.ObjectSchema<{
+    readonly externalId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
+    readonly frameId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+}, undefined>;
+export type SpawnDocumentInput = v.InferOutput<typeof spawnDocumentSchema>;
+/** Attach an imported page to a task as extra agent context. */
+export declare const linkDocumentSchema: v.ObjectSchema<{
+    readonly source: v.PicklistSchema<["confluence", "notion", "github"], undefined>;
+    readonly externalId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
+    readonly blockId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
+}, undefined>;
+export type LinkDocumentInput = v.InferOutput<typeof linkDocumentSchema>;
+//# sourceMappingURL=documents.d.ts.map

package/dist/documents.d.ts.map

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

package/dist/documents.js

@@ -0,0 +1,161 @@
+import * as v from 'valibot';
+import { blockTypeSchema } from './primitives.js';
+// ---------------------------------------------------------------------------
+// Document-source integration wire contracts. A workspace can connect to one or
+// more external document sources (Confluence, Notion, …), import requirement /
+// RFC / PRD pages from them (projected locally), expand a page into board
+// structure, or attach it to a task as agent context.
+//
+// The shapes here are deliberately source-agnostic: a `source` discriminator
+// tags every connection and document, and each provider describes the
+// credentials it needs via a {@link DocumentSourceDescriptor} so the UI can be
+// rendered generically. Storage-only bookkeeping (the owning workspace, the
+// credential bag, the soft-delete tombstone, the cached page body) is NOT on the
+// wire — it lives in the core ports / D1 layer.
+// ---------------------------------------------------------------------------
+/** The external document sources cat-factory can link to. */
+export const documentSourceKindSchema = v.picklist(['confluence', 'notion', 'github']);
+// ---- Provider self-description (drives the generic connect UI) ------------
+/** One credential a provider needs to connect (rendered as a form field). */
+export const credentialFieldSchema = v.object({
+    /** Stable key stored in the credential bag (e.g. `apiToken`). */
+    key: v.string(),
+    /** Human label for the form field. */
+    label: v.string(),
+    /** Optional helper text shown under the field. */
+    help: v.optional(v.string()),
+    /** Optional input placeholder. */
+    placeholder: v.optional(v.string()),
+    /** Render as a password input and never echo the value back. */
+    secret: v.optional(v.boolean()),
+});
+/**
+ * Everything the frontend needs to render a source's connect form and import
+ * box without hard-coding any provider specifics.
+ */
+export const documentSourceDescriptorSchema = v.object({
+    source: documentSourceKindSchema,
+    /** Display name, e.g. `Confluence`. */
+    label: v.string(),
+    /** Lucide icon name for the source. */
+    icon: v.string(),
+    /** Credentials required to connect, in display order. */
+    credentialFields: v.array(credentialFieldSchema),
+    /** Label for the "import a page" input. */
+    refLabel: v.string(),
+    /** Placeholder for the "import a page" input. */
+    refPlaceholder: v.string(),
+    /**
+     * Whether this source supports searching its catalogue by title/content (so
+     * the UI offers a search box, not just a paste-a-URL field). Optional for
+     * backward-compatibility; absent is treated as `false`.
+     */
+    searchable: v.optional(v.boolean()),
+});
+// ---- Connection + document projections ------------------------------------
+/** A workspace's connection to a document source, as exposed to clients (never the credentials). */
+export const documentConnectionSchema = v.object({
+    source: documentSourceKindSchema,
+    /** A human-friendly label for what we're connected to (site URL, workspace name). */
+    label: v.string(),
+    /** When the connection was established (epoch ms). */
+    connectedAt: v.number(),
+});
+/** A page imported from a source, projected locally. */
+export const sourceDocumentSchema = v.object({
+    source: documentSourceKindSchema,
+    /** The source's stable id for the page (Confluence page id, Notion page id). */
+    externalId: v.string(),
+    title: v.string(),
+    /** Canonical URL of the page on the source. */
+    url: v.string(),
+    /** A short plain-text excerpt of the body (full body stays in storage). */
+    excerpt: v.string(),
+    /** The board block this document is attached to as context, if any. */
+    linkedBlockId: v.nullable(v.string()),
+    /** When this projection row was last refreshed (epoch ms). */
+    syncedAt: v.number(),
+});
+/**
+ * A single hit from searching a source's catalogue. A lean shape (no body) used
+ * to populate a picker: selecting one imports it (by `externalId`) and links it
+ * to a block. Distinct from {@link SourceDocument} — a hit is not yet projected
+ * locally, so it carries no `linkedBlockId`/`syncedAt`.
+ */
+export const documentSearchResultSchema = v.object({
+    source: documentSourceKindSchema,
+    /** The source's stable id for the page (re-usable as an import ref). */
+    externalId: v.string(),
+    title: v.string(),
+    /** Canonical URL of the page on the source. */
+    url: v.string(),
+    /** A short plain-text excerpt for the result row (may be empty). */
+    excerpt: v.string(),
+});
+// ---- Board plan (doc → structure) -----------------------------------------
+/** A proposed task within a planned frame/module. */
+export const planTaskSchema = v.object({
+    title: v.string(),
+    description: v.optional(v.string()),
+});
+/** A proposed module grouping tasks within a planned frame. */
+export const planModuleSchema = v.object({
+    name: v.string(),
+    tasks: v.array(planTaskSchema),
+});
+/** A proposed top-level frame (service/api/…) with its modules and loose tasks. */
+export const planFrameSchema = v.object({
+    type: blockTypeSchema,
+    title: v.string(),
+    description: v.optional(v.string()),
+    modules: v.array(planModuleSchema),
+    tasks: v.array(planTaskSchema),
+});
+/**
+ * A proposed board structure extracted from an imported document. `planner`
+ * records whether an LLM produced it or the deterministic heading parser did, so
+ * the UI can label a preview honestly.
+ */
+export const documentBoardPlanSchema = v.object({
+    source: documentSourceKindSchema,
+    externalId: v.string(),
+    planner: v.picklist(['llm', 'headings']),
+    frames: v.array(planFrameSchema),
+});
+// ---- Request bodies -------------------------------------------------------
+/**
+ * Connect a workspace to a document source. The `credentials` bag is validated
+ * by the target provider (the `:source` is in the path), keeping the wire shape
+ * uniform across providers.
+ */
+export const connectDocumentSourceSchema = v.object({
+    credentials: v.record(v.string(), v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(2000))),
+});
+/** Import (fetch + persist) a page by its id or a full page URL. */
+export const importDocumentSchema = v.object({
+    ref: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(500)),
+});
+/** Search a source's catalogue by free text (title/content). */
+export const searchDocumentsSchema = v.object({
+    query: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(200)),
+});
+/** Preview the board structure a page would expand into (no writes). */
+export const planDocumentSchema = v.object({
+    externalId: v.pipe(v.string(), v.trim(), v.minLength(1)),
+});
+/**
+ * Apply a previously-imported page's structure to the board. Without `frameId`
+ * the plan's frames are spawned at the board root; with it, the plan's modules
+ * and tasks are spawned inside that existing frame.
+ */
+export const spawnDocumentSchema = v.object({
+    externalId: v.pipe(v.string(), v.trim(), v.minLength(1)),
+    frameId: v.optional(v.pipe(v.string(), v.minLength(1))),
+});
+/** Attach an imported page to a task as extra agent context. */
+export const linkDocumentSchema = v.object({
+    source: documentSourceKindSchema,
+    externalId: v.pipe(v.string(), v.trim(), v.minLength(1)),
+    blockId: v.pipe(v.string(), v.trim(), v.minLength(1)),
+});
+//# sourceMappingURL=documents.js.map

package/dist/documents.js.map

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