@anchrd/intel-contract 0.2.0 → 0.2.1

package/dist/contract/contract.d.ts

@@ -10,6 +10,12 @@ export declare const ProblemDetails: z.ZodObject<{
     code: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type ProblemDetails = z.infer<typeof ProblemDetails>;
+export declare const SessionUser: z.ZodObject<{
+    id: z.ZodString;
+    email: z.ZodEmail;
+    name: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type SessionUser = z.infer<typeof SessionUser>;
 export declare const KnowledgeNodeKind: z.ZodEnum<{
     folder: "folder";
     document: "document";
@@ -769,6 +775,7 @@ export declare const FlowGraph: z.ZodObject<{
 export type FlowGraph = z.infer<typeof FlowGraph>;
 export declare const Flow: z.ZodObject<{
     id: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
     title: z.ZodString;
     description: z.ZodNullable<z.ZodString>;
     ownerId: z.ZodString;
@@ -899,6 +906,7 @@ export type FlowVersion = z.infer<typeof FlowVersion>;
 export declare const FlowDocument: z.ZodObject<{
     flow: z.ZodObject<{
         id: z.ZodString;
+        parentId: z.ZodNullable<z.ZodString>;
         title: z.ZodString;
         description: z.ZodNullable<z.ZodString>;
         ownerId: z.ZodString;
@@ -1029,6 +1037,7 @@ export type FlowDocument = z.infer<typeof FlowDocument>;
 export declare const FlowList: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
+        parentId: z.ZodNullable<z.ZodString>;
         title: z.ZodString;
         description: z.ZodNullable<z.ZodString>;
         ownerId: z.ZodString;
@@ -1041,11 +1050,25 @@ export declare const FlowList: z.ZodObject<{
 }, z.core.$strict>;
 export type FlowList = z.infer<typeof FlowList>;
 export declare const CreateFlowInput: z.ZodObject<{
+    parentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     title: z.ZodString;
     description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     idempotencyKey: z.ZodString;
 }, z.core.$strict>;
 export type CreateFlowInput = z.infer<typeof CreateFlowInput>;
+export declare const UpdateFlowInput: z.ZodObject<{
+    flowId: z.ZodString;
+    baseUpdatedAt: z.ZodISODateTime;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    idempotencyKey: z.ZodString;
+}, z.core.$strict>;
+export type UpdateFlowInput = z.infer<typeof UpdateFlowInput>;
+export declare const ListFlowsInput: z.ZodObject<{
+    parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type ListFlowsInput = z.infer<typeof ListFlowsInput>;
 export declare const GetFlowInput: z.ZodObject<{
     flowId: z.ZodString;
 }, z.core.$strict>;

package/dist/contract/contract.js

@@ -9,6 +9,13 @@ export const ProblemDetails = z.strictObject({
     instance: z.string().optional(),
     code: z.string().optional(),
 });
+// Who the caller is, as Gate resolved it from the bearer. Deliberately identity only: no
+// capabilities, no token, nothing a surface could mistake for a permission.
+export const SessionUser = z.strictObject({
+    id: IntelId,
+    email: z.email(),
+    name: z.string().min(1).max(240).nullable(),
+});
 export const KnowledgeNodeKind = z.enum(["folder", "document", "attachment"]);
 export const ContextPolicy = z.enum(["pinned", "relevant", "explicit"]);
 export const ResourceRole = z.enum(["viewer", "commenter", "editor", "manager"]);
@@ -343,6 +350,10 @@ export const FlowGraph = z.strictObject({
 });
 export const Flow = z.strictObject({
     id: IntelId,
+    // The one thing a Flow shares with a document: its place in the Knowledge folder tree (ADR-0004).
+    // Everything else stays apart — versions, R2 body and Vectorize belong to the document, the graph,
+    // runs and approvals to the flow. `null` is the root of that same tree.
+    parentId: IntelId.nullable(),
     title: z.string().min(1).max(240),
     description: z.string().max(2_000).nullable(),
     ownerId: IntelId,
@@ -366,10 +377,30 @@ export const FlowDocument = z.strictObject({
 });
 export const FlowList = z.strictObject({ items: z.array(Flow) });
 export const CreateFlowInput = z.strictObject({
+    parentId: IntelId.nullable().default(null),
     title: z.string().trim().min(1).max(240),
     description: z.string().trim().max(2_000).nullable().default(null),
     idempotencyKey: z.string().min(8).max(200),
 });
+// Renaming and moving a flow. Both are organization and nothing else: they touch no version, no
+// published graph and no run, because organization has to stay free of consequence or nobody dares
+// to reorganize (ADR-0004).
+export const UpdateFlowInput = z
+    .strictObject({
+    flowId: IntelId,
+    baseUpdatedAt: IsoDateTime,
+    title: z.string().trim().min(1).max(240).optional(),
+    description: z.string().trim().max(2_000).nullable().optional(),
+    parentId: IntelId.nullable().optional(),
+    idempotencyKey: z.string().min(8).max(200),
+})
+    .refine((input) => input.title !== undefined || input.description !== undefined || input.parentId !== undefined, { error: "At least one change is required" });
+// Three answers, not two: an absent `parentId` lists every visible flow (the search dialog asks
+// that), `null` lists the root of the shared tree and an ID lists one folder (the sidebar tree asks
+// per level, which is what keeps the tree off the N+1 it used to load with).
+export const ListFlowsInput = z.strictObject({
+    parentId: IntelId.nullable().optional(),
+});
 export const GetFlowInput = z.strictObject({ flowId: IntelId });
 export const SaveFlowVersionInput = z.strictObject({
     flowId: IntelId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anchrd/intel-contract",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "license": "UNLICENSED",
   "repository": {