@agent-relay/factory 0.1.56 → 0.1.58

package/dist/intake/notion.d.ts

@@ -0,0 +1,375 @@
+import { z } from 'zod';
+declare const recipeSchema: z.ZodEnum<["single", "workflow", "team"]>;
+declare const targetSchema: z.ZodUnion<[z.ZodObject<{
+    repo: z.ZodString;
+    labels: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    publicSummary: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    labels: string[];
+    repo: string;
+    publicSummary?: string | undefined;
+}, {
+    repo: string;
+    labels?: string[] | undefined;
+    publicSummary?: string | undefined;
+}>, z.ZodObject<{
+    projectPath: z.ZodEffects<z.ZodString, string, string>;
+    node: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    projectPath: string;
+    node?: string | undefined;
+}, {
+    projectPath: string;
+    node?: string | undefined;
+}>]>;
+declare const contractDeliverySchema: z.ZodObject<{
+    kind: z.ZodLiteral<"relay-channel">;
+    channel: z.ZodString;
+    messageIds: z.ZodArray<z.ZodString, "many">;
+    encoding: z.ZodLiteral<"base64-chunks-v1">;
+}, "strict", z.ZodTypeAny, {
+    kind: "relay-channel";
+    channel: string;
+    encoding: "base64-chunks-v1";
+    messageIds: string[];
+}, {
+    kind: "relay-channel";
+    channel: string;
+    encoding: "base64-chunks-v1";
+    messageIds: string[];
+}>;
+declare const manifestSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    mountRoot: z.ZodDefault<z.ZodString>;
+    workerMountRoot: z.ZodDefault<z.ZodString>;
+    workerMountTransport: z.ZodDefault<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"local">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "local";
+    }, {
+        kind: "local";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"relay-channel">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "relay-channel";
+    }, {
+        kind: "relay-channel";
+    }>]>>;
+    statePath: z.ZodDefault<z.ZodString>;
+    tasks: z.ZodArray<z.ZodObject<{
+        page: z.ZodString;
+        bootstrap: z.ZodOptional<z.ZodObject<{
+            authorizedPageId: z.ZodString;
+            reason: z.ZodString;
+            status: z.ZodLiteral<"ready">;
+            title: z.ZodString;
+            recipe: z.ZodEnum<["single", "workflow", "team"]>;
+            summary: z.ZodString;
+            targets: z.ZodArray<z.ZodUnion<[z.ZodObject<{
+                repo: z.ZodString;
+                labels: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+                publicSummary: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                labels: string[];
+                repo: string;
+                publicSummary?: string | undefined;
+            }, {
+                repo: string;
+                labels?: string[] | undefined;
+                publicSummary?: string | undefined;
+            }>, z.ZodObject<{
+                projectPath: z.ZodEffects<z.ZodString, string, string>;
+                node: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                projectPath: string;
+                node?: string | undefined;
+            }, {
+                projectPath: string;
+                node?: string | undefined;
+            }>]>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            status: "ready";
+            recipe: "workflow" | "team" | "single";
+            reason: string;
+            title: string;
+            targets: ({
+                labels: string[];
+                repo: string;
+                publicSummary?: string | undefined;
+            } | {
+                projectPath: string;
+                node?: string | undefined;
+            })[];
+            summary: string;
+            authorizedPageId: string;
+        }, {
+            status: "ready";
+            recipe: "workflow" | "team" | "single";
+            reason: string;
+            title: string;
+            targets: ({
+                repo: string;
+                labels?: string[] | undefined;
+                publicSummary?: string | undefined;
+            } | {
+                projectPath: string;
+                node?: string | undefined;
+            })[];
+            summary: string;
+            authorizedPageId: string;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        page: string;
+        bootstrap?: {
+            status: "ready";
+            recipe: "workflow" | "team" | "single";
+            reason: string;
+            title: string;
+            targets: ({
+                labels: string[];
+                repo: string;
+                publicSummary?: string | undefined;
+            } | {
+                projectPath: string;
+                node?: string | undefined;
+            })[];
+            summary: string;
+            authorizedPageId: string;
+        } | undefined;
+    }, {
+        page: string;
+        bootstrap?: {
+            status: "ready";
+            recipe: "workflow" | "team" | "single";
+            reason: string;
+            title: string;
+            targets: ({
+                repo: string;
+                labels?: string[] | undefined;
+                publicSummary?: string | undefined;
+            } | {
+                projectPath: string;
+                node?: string | undefined;
+            })[];
+            summary: string;
+            authorizedPageId: string;
+        } | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    version: 1;
+    mountRoot: string;
+    tasks: {
+        page: string;
+        bootstrap?: {
+            status: "ready";
+            recipe: "workflow" | "team" | "single";
+            reason: string;
+            title: string;
+            targets: ({
+                labels: string[];
+                repo: string;
+                publicSummary?: string | undefined;
+            } | {
+                projectPath: string;
+                node?: string | undefined;
+            })[];
+            summary: string;
+            authorizedPageId: string;
+        } | undefined;
+    }[];
+    workerMountRoot: string;
+    workerMountTransport: {
+        kind: "local";
+    } | {
+        kind: "relay-channel";
+    };
+    statePath: string;
+}, {
+    version: 1;
+    tasks: {
+        page: string;
+        bootstrap?: {
+            status: "ready";
+            recipe: "workflow" | "team" | "single";
+            reason: string;
+            title: string;
+            targets: ({
+                repo: string;
+                labels?: string[] | undefined;
+                publicSummary?: string | undefined;
+            } | {
+                projectPath: string;
+                node?: string | undefined;
+            })[];
+            summary: string;
+            authorizedPageId: string;
+        } | undefined;
+    }[];
+    mountRoot?: string | undefined;
+    workerMountRoot?: string | undefined;
+    workerMountTransport?: {
+        kind: "local";
+    } | {
+        kind: "relay-channel";
+    } | undefined;
+    statePath?: string | undefined;
+}>;
+export type NotionRecipe = z.infer<typeof recipeSchema>;
+export type NotionIntakeTarget = z.infer<typeof targetSchema>;
+export type NotionIntakeManifest = z.infer<typeof manifestSchema>;
+export interface NormalizedNotionTask {
+    pageId: string;
+    sourceKey: string;
+    sourcePath: string;
+    workerSourcePath: string;
+    content: string;
+    authorizationDigestInput?: string;
+    contentDigest: string;
+    digest: string;
+    title: string;
+    summary: string;
+    recipe: NotionRecipe;
+    target: NotionIntakeTarget;
+    bootstrap: boolean;
+}
+export interface ExistingGithubIssue {
+    number: number;
+    url: string;
+    body: string;
+}
+export interface GithubIssuePublisher {
+    repositoryVisibility(repo: string): Promise<'public' | 'private' | 'internal'>;
+    missingLabels(repo: string, labels: readonly string[]): Promise<string[]>;
+    findBySource(repo: string, sourceKey: string): Promise<ExistingGithubIssue | undefined>;
+    createIssue(input: {
+        repo: string;
+        title: string;
+        body: string;
+        labels: readonly string[];
+    }): Promise<{
+        number: number;
+        url: string;
+    }>;
+    updateIssue(input: {
+        repo: string;
+        number: number;
+        body: string;
+    }): Promise<void>;
+}
+export type NotionContractDelivery = z.infer<typeof contractDeliverySchema>;
+export interface NotionContractPublisher {
+    publish(input: {
+        pageId: string;
+        sourceKey: string;
+        content: string;
+        contentDigest: string;
+    }): Promise<NotionContractDelivery>;
+    dispose?(): Promise<void>;
+}
+export interface NotionIntakeClaim {
+    sourceKey: string;
+    digest: string;
+    claimedAt: string;
+}
+export interface NotionIntakeClaimStore {
+    get(sourceKey: string): Promise<NotionIntakeClaim | undefined>;
+    claim(input: NotionIntakeClaim): Promise<{
+        status: 'claimed' | 'existing';
+        claim: NotionIntakeClaim;
+    }>;
+    dispose?(): Promise<void>;
+}
+export interface WorkspaceTaskDispatcher {
+    find?(name: string): Promise<{
+        agent: string;
+        node?: string;
+    } | undefined>;
+    dispatch(input: {
+        name: string;
+        invocationId: string;
+        node?: string;
+        projectPath: string;
+        title: string;
+        task: string;
+    }): Promise<{
+        agent: string;
+        node?: string;
+        status?: string;
+    }>;
+    redispatch?(input: {
+        name: string;
+        invocationId: string;
+        node?: string;
+        projectPath: string;
+        title: string;
+        task: string;
+    }): Promise<{
+        agent: string;
+        node?: string;
+        status?: string;
+    }>;
+}
+export type NotionIntakeResult = {
+    sourceKey: string;
+    pageId: string;
+    target: NotionIntakeTarget;
+    status: 'ready' | 'dispatched' | 'already-dispatched' | 'blocked';
+    digest: string;
+    issue?: {
+        number: number;
+        url: string;
+    };
+    agent?: string;
+    node?: string;
+    reason?: string;
+};
+export interface NotionIntakeReport {
+    ok: boolean;
+    dispatch: boolean;
+    results: NotionIntakeResult[];
+}
+/** Load and validate an operator-reviewed intake manifest with paths resolved from the manifest directory. */
+export declare function loadNotionIntakeManifest(path: string): Promise<NotionIntakeManifest>;
+/** Plan or execute every mounted Notion destination and return one durable result per source key. */
+export declare function runNotionIntake(input: {
+    manifest: NotionIntakeManifest;
+    dispatch: boolean;
+    github?: GithubIssuePublisher;
+    workspace?: WorkspaceTaskDispatcher;
+    contracts?: NotionContractPublisher;
+    claims?: NotionIntakeClaimStore;
+    now?: () => Date;
+}): Promise<NotionIntakeReport>;
+/** Read mounted page bodies and normalize strict headers or exact bootstrap mappings into Factory tasks. */
+export declare function normalizeNotionManifest(manifest: NotionIntakeManifest): Promise<NormalizedNotionTask[]>;
+/** Extract one boundary-delimited Notion UUID from a bare identifier or application URL. */
+export declare function normalizeNotionPageId(value: string): string;
+/** Parse the fail-closed Chief Spec header at the start of a mounted Notion page. */
+export declare function parseChiefSpecHeader(content: string): {
+    title: string;
+    summary: string;
+    recipe: NotionRecipe;
+    targets: NotionIntakeTarget[];
+};
+/** GitHub CLI publisher with shell-free arguments, bounded output, and source-marker reconciliation. */
+export declare class GhCliIssuePublisher implements GithubIssuePublisher {
+    repositoryVisibility(repo: string): Promise<'public' | 'private' | 'internal'>;
+    missingLabels(repo: string, labels: readonly string[]): Promise<string[]>;
+    findBySource(repo: string, sourceKey: string): Promise<ExistingGithubIssue | undefined>;
+    createIssue(input: {
+        repo: string;
+        title: string;
+        body: string;
+        labels: readonly string[];
+    }): Promise<{
+        number: number;
+        url: string;
+    }>;
+    updateIssue(input: {
+        repo: string;
+        number: number;
+        body: string;
+    }): Promise<void>;
+}
+export {};
+//# sourceMappingURL=notion.d.ts.map

package/dist/intake/notion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notion.d.ts","sourceRoot":"","sources":["../../src/intake/notion.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,QAAA,MAAM,YAAY,2CAAyC,CAAA;AAa3D,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;IAAqD,CAAA;AAYvE,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;EAKjB,CAAA;AAYX,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUT,CAAA;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AACvD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAC7D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAEjE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC,CAAA;IAC9E,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACzE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAA;IACvF,WAAW,CAAC,KAAK,EAAE;QACjB,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;KAC1B,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC5C,WAAW,CAAC,KAAK,EAAE;QACjB,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAA;KACb,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClB;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,KAAK,EAAE;QACb,MAAM,EAAE,MAAM,CAAA;QACd,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,aAAa,EAAE,MAAM,CAAA;KACtB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;IACnC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAA;IAC9D,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC;QACvC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAA;QAC9B,KAAK,EAAE,iBAAiB,CAAA;KACzB,CAAC,CAAA;IACF,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAA;IAC1E,QAAQ,CAAC,KAAK,EAAE;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,YAAY,EAAE,MAAM,CAAA;QACpB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,WAAW,EAAE,MAAM,CAAA;QACnB,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;KACb,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC9D,UAAU,CAAC,CAAC,KAAK,EAAE;QACjB,IAAI,EAAE,MAAM,CAAA;QACZ,YAAY,EAAE,MAAM,CAAA;QACpB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,WAAW,EAAE,MAAM,CAAA;QACnB,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;KACb,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC/D;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,kBAAkB,CAAA;IAC1B,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,oBAAoB,GAAG,SAAS,CAAA;IACjE,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAA;IACX,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAC9B;AAsBD,8GAA8G;AAC9G,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAS1F;AAED,qGAAqG;AACrG,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAC3C,QAAQ,EAAE,oBAAoB,CAAA;IAC9B,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,oBAAoB,CAAA;IAC7B,SAAS,CAAC,EAAE,uBAAuB,CAAA;IACnC,SAAS,CAAC,EAAE,uBAAuB,CAAA;IACnC,MAAM,CAAC,EAAE,sBAAsB,CAAA;IAC/B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAe9B;AA+CD,4GAA4G;AAC5G,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA0C7G;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG;IACrD,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,YAAY,CAAA;IACpB,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAC9B,CAkCA;AAED,wGAAwG;AACxG,qBAAa,mBAAoB,YAAW,oBAAoB;IACxD,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IAQ9E,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMzE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAWvF,WAAW,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAStI,WAAW,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxF"}