@decaf-ts/integrations 0.3.6 → 0.3.7

package/lib/types/namespaces/types.d.mts

@@ -0,0 +1,230 @@
+export declare enum IsolationTier {
+    Pooled = "pooled",
+    Bridge = "bridge",
+    Silo = "silo"
+}
+export declare enum MembershipStatus {
+    Invited = "invited",
+    Active = "active",
+    Suspended = "suspended",
+    Removed = "removed"
+}
+export declare enum PrincipalKind {
+    User = "user",
+    Group = "group",
+    ServiceAccount = "service_account",
+    Agent = "agent",
+    ApiKey = "api_key"
+}
+export declare enum ScopeKind {
+    Tenant = "tenant",
+    OrgUnit = "org_unit",
+    Resource = "resource"
+}
+export declare enum PermissionCategory {
+    Admin = "admin",
+    ContentRead = "content_read",
+    ContentWrite = "content_write",
+    Memory = "memory",
+    Graph = "graph",
+    Vector = "vector",
+    Export = "export",
+    Billing = "billing",
+    Audit = "audit",
+    Security = "security",
+    Data = "data",
+    Automation = "automation"
+}
+export declare enum ResourceVisibility {
+    Private = "private",
+    ResourceAcl = "resource_acl",
+    OrgUnit = "org_unit",
+    OrgSubtree = "org_subtree",
+    Tenant = "tenant"
+}
+export declare enum StorageKind {
+    Postgres = "postgres",
+    Arango = "arango",
+    Qdrant = "qdrant",
+    ObjectStorage = "object_storage"
+}
+export declare enum StorageBindingKind {
+    Shared = "shared",
+    Dedicated = "dedicated"
+}
+export declare const IsolationTierOptions: IsolationTier[];
+export declare const MembershipStatusOptions: MembershipStatus[];
+export declare const PrincipalKindOptions: PrincipalKind[];
+export declare const ScopeKindOptions: ScopeKind[];
+export declare const PermissionCategoryOptions: PermissionCategory[];
+export declare const ResourceVisibilityOptions: ResourceVisibility[];
+export declare const StorageKindOptions: StorageKind[];
+export declare const StorageBindingKindOptions: StorageBindingKind[];
+export type TxArgs = any[];
+export interface CreateTenantInput {
+    slug: string;
+    name: string;
+    isolationTier?: IsolationTier;
+    profileKey?: string;
+    profileMetadata?: Record<string, unknown>;
+}
+export interface CreateUserInput {
+    email?: string;
+    phone?: string;
+    displayName: string;
+}
+export interface CreateOrgUnitInput {
+    tenantId: string;
+    parentOrgUnitId?: string;
+    name: string;
+    metadata?: Record<string, unknown>;
+    profileKey?: string;
+    profileMetadata?: Record<string, unknown>;
+}
+export interface CreateRoleInput {
+    tenantId?: string;
+    key: string;
+    name: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CreatePermissionInput {
+    key: string;
+    category: PermissionCategory;
+    description?: string;
+}
+export interface AssignRoleInput {
+    tenantId: string;
+    principalId: string;
+    roleId: string;
+    scopeKind: ScopeKind;
+    scopeId: string;
+    inheritDown?: boolean;
+    startsAt?: Date;
+    expiresAt?: Date;
+    conditions?: Record<string, unknown>;
+}
+export interface RegisterResourceInput {
+    tenantId: string;
+    orgUnitId: string;
+    resourceType: string;
+    resourceId: string;
+    visibility: ResourceVisibility;
+    ownerPrincipalId?: string;
+    sensitivity?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface GrantResourceInput {
+    tenantId: string;
+    resourceId: string;
+    principalId: string;
+    permissionKey: string;
+    startsAt?: Date;
+    expiresAt?: Date;
+    conditions?: Record<string, unknown>;
+    createdByPrincipalId?: string;
+}
+export interface CanAccessInput {
+    tenantId: string;
+    principalId: string;
+    permissionKey: string;
+    resourceProtectedId?: string;
+    scopeKind?: ScopeKind;
+    scopeId?: string;
+    at?: Date;
+}
+export interface AccessContext {
+    tenantId: string;
+    principalId: string;
+    permissionsByScope: Record<string, string[]>;
+    allowedOrgUnitIdsByPermission: Record<string, string[]>;
+    resourceGrants: Array<{
+        resourceId: string;
+        permissionKey: string;
+    }>;
+}
+export interface ArangoAuthContext {
+    tenantId: string;
+    principalId: string;
+    permissionKey: string;
+    allowedOrgUnitIds: string[];
+    allowedResourceIds: string[];
+}
+export interface QdrantAuthFilter {
+    must: Array<Record<string, unknown>>;
+    must_not?: Array<Record<string, unknown>>;
+}
+export interface CreateStorageBindingInput {
+    tenantId: string;
+    storageKind: StorageKind;
+    bindingKind: StorageBindingKind;
+    bindingKey: string;
+    region: string;
+    config?: Record<string, unknown>;
+}
+export interface BootstrapPermission {
+    key: string;
+    category: PermissionCategory;
+    description?: string;
+}
+export interface BootstrapRole {
+    key: string;
+    name: string;
+    description?: string;
+    permissionKeys: string[];
+}
+export interface BootstrapOrgUnit {
+    name: string;
+    profileKey?: string;
+    metadata?: Record<string, unknown>;
+    children?: BootstrapOrgUnit[];
+}
+export interface BootstrapTemplate {
+    tenant: CreateTenantInput;
+    rootOrgUnit: BootstrapOrgUnit;
+    permissions: BootstrapPermission[];
+    roles: BootstrapRole[];
+    ownerUser: CreateUserInput;
+    ownerRoleKey: string;
+}
+export interface ResourceSnapshot {
+    id: string;
+    tenantId: string;
+    orgUnitId: string;
+    resourceType: string;
+    resourceId: string;
+    visibility: ResourceVisibility;
+    ownerPrincipalId?: string;
+    sensitivity?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface GrantSnapshot {
+    id: string;
+    tenantId: string;
+    resourceId: string;
+    principalId: string;
+    permissionKey: string;
+    startsAt?: Date;
+    expiresAt?: Date;
+    conditions?: Record<string, unknown>;
+    createdByPrincipalId?: string;
+}
+export interface EffectivePermissionSnapshot {
+    id: string;
+    tenantId: string;
+    principalId: string;
+    permissionKey: string;
+    scopeKind: ScopeKind;
+    scopeId: string;
+    sourceKind: string;
+    sourceId: string;
+    startsAt?: Date;
+    expiresAt?: Date;
+}
+export interface AuthzDataSources {
+    loadResource?: (tenantId: string, protectedResourceId: string) => Promise<ResourceSnapshot | undefined>;
+    listResourceGrants?: (tenantId: string, protectedResourceId: string) => Promise<GrantSnapshot[]>;
+    listPrincipalGrants?: (tenantId: string, principalId: string) => Promise<GrantSnapshot[]>;
+    listEffectivePermissions?: (tenantId: string, principalId: string) => Promise<EffectivePermissionSnapshot[]>;
+    listEffectivePermissionsForScope?: (tenantId: string, scopeKind: ScopeKind, scopeId: string) => Promise<EffectivePermissionSnapshot[]>;
+}

package/lib/types/namespaces/utils.d.cts

@@ -0,0 +1,68 @@
+import { Cascade, ModelService, Repository } from "@decaf-ts/core";
+import { Model } from "@decaf-ts/decorator-validation";
+import { AccessContext, ArangoAuthContext, EffectivePermissionSnapshot, GrantSnapshot, QdrantAuthFilter } from "./types.d.cts";
+export declare const REL_RESTRICT: {
+    readonly update: Cascade.NONE;
+    readonly delete: Cascade.NONE;
+    readonly nullable: false;
+};
+export declare const REL_NULLIFY: {
+    readonly update: Cascade.NONE;
+    readonly delete: Cascade.NONE;
+    readonly nullable: true;
+};
+export declare const REL_CASCADE_DEPENDENT: {
+    readonly update: Cascade.CASCADE;
+    readonly delete: Cascade.CASCADE;
+    readonly nullable: false;
+};
+export declare const REL_CASCADE_INSERT_UPDATE: {
+    readonly update: Cascade.CASCADE;
+    readonly delete: Cascade.NONE;
+    readonly nullable: false;
+};
+export declare function buildArangoContext(options: {
+    tenantId: string;
+    principalId: string;
+    permissionKey: string;
+    allowedOrgUnitIds: string[];
+    allowedResourceIds: string[];
+}): ArangoAuthContext;
+export declare function buildQdrantFilter(options: {
+    tenantId: string;
+    principalId: string;
+    permissionKey: string;
+    allowedOrgUnitIds: string[];
+    allowedResourceIds: string[];
+}): QdrantAuthFilter;
+export declare function nowIso(): Date;
+export declare function asArray<T>(value: T[] | undefined): T[];
+export declare function sameTenant(rowTenant: unknown, tenantId: string): boolean;
+export declare function relationMatch(value: unknown, target: string | undefined): boolean;
+export declare function lowerSlug(value: string): string;
+export declare function isTimeValid(at: Date | undefined, startsAt?: Date, expiresAt?: Date): boolean;
+export declare function buildAccessContext(options: {
+    tenantId: string;
+    principalId: string;
+    permissions: EffectivePermissionSnapshot[];
+    grants: GrantSnapshot[];
+}): AccessContext;
+export declare abstract class BaseModelService<M extends Model<boolean> & {
+    id: string;
+}> extends ModelService<M, Repository<M, any>> {
+    protected constructor(clazz: new () => M);
+    protected newModel<T>(clazz: new () => T, data: Partial<T>): T;
+    create(data: Partial<M>, ...args: any[]): Promise<M>;
+    createOne(data: Partial<M>, ...args: any[]): Promise<M>;
+    getById(id: string, ...args: any[]): Promise<M>;
+    updateOne(id: string, patch: Partial<M>, ...args: any[]): Promise<M>;
+    deleteById(id: string, ...args: any[]): Promise<void>;
+    findOneBy<K extends keyof M & string>(key: K, value: M[K], ...args: any[]): Promise<M>;
+    findManyBy<K extends keyof M & string>(key: K, value: M[K], ...args: any[]): Promise<M[]>;
+    listAll(...args: any[]): Promise<M[]>;
+}
+export declare function id(): string;
+export declare function relationId(value: string | {
+    id: string;
+}): string;
+export { AuthorizationError, transactional } from "@decaf-ts/core";

package/lib/types/namespaces/utils.d.mts

@@ -0,0 +1,68 @@
+import { Cascade, ModelService, Repository } from "@decaf-ts/core";
+import { Model } from "@decaf-ts/decorator-validation";
+import { AccessContext, ArangoAuthContext, EffectivePermissionSnapshot, GrantSnapshot, QdrantAuthFilter } from "./types.d.mts";
+export declare const REL_RESTRICT: {
+    readonly update: Cascade.NONE;
+    readonly delete: Cascade.NONE;
+    readonly nullable: false;
+};
+export declare const REL_NULLIFY: {
+    readonly update: Cascade.NONE;
+    readonly delete: Cascade.NONE;
+    readonly nullable: true;
+};
+export declare const REL_CASCADE_DEPENDENT: {
+    readonly update: Cascade.CASCADE;
+    readonly delete: Cascade.CASCADE;
+    readonly nullable: false;
+};
+export declare const REL_CASCADE_INSERT_UPDATE: {
+    readonly update: Cascade.CASCADE;
+    readonly delete: Cascade.NONE;
+    readonly nullable: false;
+};
+export declare function buildArangoContext(options: {
+    tenantId: string;
+    principalId: string;
+    permissionKey: string;
+    allowedOrgUnitIds: string[];
+    allowedResourceIds: string[];
+}): ArangoAuthContext;
+export declare function buildQdrantFilter(options: {
+    tenantId: string;
+    principalId: string;
+    permissionKey: string;
+    allowedOrgUnitIds: string[];
+    allowedResourceIds: string[];
+}): QdrantAuthFilter;
+export declare function nowIso(): Date;
+export declare function asArray<T>(value: T[] | undefined): T[];
+export declare function sameTenant(rowTenant: unknown, tenantId: string): boolean;
+export declare function relationMatch(value: unknown, target: string | undefined): boolean;
+export declare function lowerSlug(value: string): string;
+export declare function isTimeValid(at: Date | undefined, startsAt?: Date, expiresAt?: Date): boolean;
+export declare function buildAccessContext(options: {
+    tenantId: string;
+    principalId: string;
+    permissions: EffectivePermissionSnapshot[];
+    grants: GrantSnapshot[];
+}): AccessContext;
+export declare abstract class BaseModelService<M extends Model<boolean> & {
+    id: string;
+}> extends ModelService<M, Repository<M, any>> {
+    protected constructor(clazz: new () => M);
+    protected newModel<T>(clazz: new () => T, data: Partial<T>): T;
+    create(data: Partial<M>, ...args: any[]): Promise<M>;
+    createOne(data: Partial<M>, ...args: any[]): Promise<M>;
+    getById(id: string, ...args: any[]): Promise<M>;
+    updateOne(id: string, patch: Partial<M>, ...args: any[]): Promise<M>;
+    deleteById(id: string, ...args: any[]): Promise<void>;
+    findOneBy<K extends keyof M & string>(key: K, value: M[K], ...args: any[]): Promise<M>;
+    findManyBy<K extends keyof M & string>(key: K, value: M[K], ...args: any[]): Promise<M[]>;
+    listAll(...args: any[]): Promise<M[]>;
+}
+export declare function id(): string;
+export declare function relationId(value: string | {
+    id: string;
+}): string;
+export { AuthorizationError, transactional } from "@decaf-ts/core";

package/lib/types/nest/graph/GraphExecutionController.d.cts

@@ -0,0 +1,62 @@
+/**
+ * @module integrations/nest/graph/GraphExecutionController
+ * @summary NestJS controller bridging the graph execution engine to REST + SSE.
+ * @description Exposes three endpoints:
+ * - `POST /graph/execute` — triggers {@link GraphExecutionEngine.execute}, persists the result via a Decaf repository, and returns `{ runId, status, outputs }`.
+ * - `GET /graph/events` — SSE endpoint streaming {@link GraphExecutionEvent}s as `[modelName, operation, id, payload]` tuples (compatible with for-http's `ServerEventConnector`).
+ * - `GET /graph/results/:runId` — retrieves a persisted {@link GraphExecutionResultModel} from the repository.
+ *
+ * This is the production pattern: for-nest hosts the engine, for-angular consumes events over the network via SSE and fetches persisted results via REST.
+ */
+import { MessageEvent } from "@nestjs/common";
+import { Observable } from "rxjs";
+import { GraphExecutionEngine, type GraphExecutionValues } from "../../graph/index.d.cts";
+import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
+import { type GraphExecutionResultRepositoryInstance } from "./GraphExecutionResultRepository.d.cts";
+/**
+ * NestJS injection token for the graph execution result repository.
+ */
+export declare const GRAPH_RESULT_REPOSITORY = "GRAPH_RESULT_REPOSITORY";
+/**
+ * Payload for the `POST /graph/execute` endpoint.
+ */
+export interface GraphExecutePayload {
+    workflow: GraphWorkflowDefinition;
+    inputs: GraphExecutionValues;
+}
+/**
+ * Response shape for the `POST /graph/execute` endpoint.
+ */
+export interface GraphExecuteResponse {
+    runId: string;
+    status: string;
+    outputs: Record<string, unknown>;
+}
+/**
+ * NestJS controller that hosts the graph execution engine server-side,
+ * streams events via SSE, and persists results for later retrieval.
+ */
+export declare class GraphExecutionController {
+    private readonly engine;
+    private readonly resultRepository;
+    private readonly eventSubject;
+    constructor(engine: GraphExecutionEngine, resultRepository: GraphExecutionResultRepositoryInstance);
+    /**
+     * Triggers graph execution server-side, persists the result, and returns
+     * a summary containing the `runId`, `status`, and `outputs`.
+     */
+    execute(body: GraphExecutePayload): Promise<GraphExecuteResponse>;
+    /**
+     * SSE endpoint that streams graph execution events.
+     *
+     * Events are serialized as `[modelName, operation, id, payload]` to match
+     * the format expected by for-http's `ServerEventConnector`.
+     */
+    events(): Observable<MessageEvent>;
+    /**
+     * Retrieves a persisted graph execution result by its `runId`.
+     *
+     * @throws {NotFoundException} when no result is stored for the given `runId`.
+     */
+    getResult(runId: string): Promise<unknown>;
+}

package/lib/types/nest/graph/GraphExecutionController.d.mts

@@ -0,0 +1,62 @@
+/**
+ * @module integrations/nest/graph/GraphExecutionController
+ * @summary NestJS controller bridging the graph execution engine to REST + SSE.
+ * @description Exposes three endpoints:
+ * - `POST /graph/execute` — triggers {@link GraphExecutionEngine.execute}, persists the result via a Decaf repository, and returns `{ runId, status, outputs }`.
+ * - `GET /graph/events` — SSE endpoint streaming {@link GraphExecutionEvent}s as `[modelName, operation, id, payload]` tuples (compatible with for-http's `ServerEventConnector`).
+ * - `GET /graph/results/:runId` — retrieves a persisted {@link GraphExecutionResultModel} from the repository.
+ *
+ * This is the production pattern: for-nest hosts the engine, for-angular consumes events over the network via SSE and fetches persisted results via REST.
+ */
+import { MessageEvent } from "@nestjs/common";
+import { Observable } from "rxjs";
+import { GraphExecutionEngine, type GraphExecutionValues } from "../../graph/index.d.mts";
+import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
+import { type GraphExecutionResultRepositoryInstance } from "./GraphExecutionResultRepository.d.mts";
+/**
+ * NestJS injection token for the graph execution result repository.
+ */
+export declare const GRAPH_RESULT_REPOSITORY = "GRAPH_RESULT_REPOSITORY";
+/**
+ * Payload for the `POST /graph/execute` endpoint.
+ */
+export interface GraphExecutePayload {
+    workflow: GraphWorkflowDefinition;
+    inputs: GraphExecutionValues;
+}
+/**
+ * Response shape for the `POST /graph/execute` endpoint.
+ */
+export interface GraphExecuteResponse {
+    runId: string;
+    status: string;
+    outputs: Record<string, unknown>;
+}
+/**
+ * NestJS controller that hosts the graph execution engine server-side,
+ * streams events via SSE, and persists results for later retrieval.
+ */
+export declare class GraphExecutionController {
+    private readonly engine;
+    private readonly resultRepository;
+    private readonly eventSubject;
+    constructor(engine: GraphExecutionEngine, resultRepository: GraphExecutionResultRepositoryInstance);
+    /**
+     * Triggers graph execution server-side, persists the result, and returns
+     * a summary containing the `runId`, `status`, and `outputs`.
+     */
+    execute(body: GraphExecutePayload): Promise<GraphExecuteResponse>;
+    /**
+     * SSE endpoint that streams graph execution events.
+     *
+     * Events are serialized as `[modelName, operation, id, payload]` to match
+     * the format expected by for-http's `ServerEventConnector`.
+     */
+    events(): Observable<MessageEvent>;
+    /**
+     * Retrieves a persisted graph execution result by its `runId`.
+     *
+     * @throws {NotFoundException} when no result is stored for the given `runId`.
+     */
+    getResult(runId: string): Promise<unknown>;
+}

package/lib/types/nest/graph/GraphExecutionModule.d.cts

@@ -0,0 +1,39 @@
+/**
+ * @module integrations/nest/graph/GraphExecutionModule
+ * @summary NestJS DynamicModule hosting the graph execution engine.
+ * @description Wires the {@link GraphExecutionEngine}, a demo executor registry, a RamAdapter-backed result repository, and the {@link GraphExecutionController} into a single NestJS module. Use `GraphExecutionModule.forRoot()` to register it in the application.
+ */
+import { DynamicModule } from "@nestjs/common";
+/**
+ * Options for {@link GraphExecutionModule.forRoot}.
+ */
+export interface GraphExecutionModuleOptions {
+    /**
+     * User identifier passed to the RamAdapter. Defaults to `"graph-engine"`.
+     */
+    adapterUser?: string;
+    /**
+     * When `true`, calls `RamAdapter.decoration()` and
+     * `Adapter.setCurrent(RamFlavour)` during module initialisation. Defaults to
+     * `true`. Set to `false` when the host application has already configured a
+     * RamAdapter.
+     */
+    initAdapter?: boolean;
+}
+/**
+ * NestJS module that hosts the graph execution engine server-side.
+ *
+ * Provides:
+ * - {@link GraphExecutionEngine} — singleton engine with a demo executor registry.
+ * - `GRAPH_RESULT_REPOSITORY` — Decaf repository for {@link GraphExecutionResultModel} backed by RamAdapter.
+ * - {@link GraphExecutionController} — REST + SSE controller.
+ */
+export declare class GraphExecutionModule {
+    /**
+     * Creates a configured {@link DynamicModule} for the graph execution backend.
+     *
+     * @param options - Module configuration options.
+     * @returns A NestJS `DynamicModule` ready for import.
+     */
+    static forRoot(options?: GraphExecutionModuleOptions): DynamicModule;
+}

package/lib/types/nest/graph/GraphExecutionModule.d.mts

@@ -0,0 +1,39 @@
+/**
+ * @module integrations/nest/graph/GraphExecutionModule
+ * @summary NestJS DynamicModule hosting the graph execution engine.
+ * @description Wires the {@link GraphExecutionEngine}, a demo executor registry, a RamAdapter-backed result repository, and the {@link GraphExecutionController} into a single NestJS module. Use `GraphExecutionModule.forRoot()` to register it in the application.
+ */
+import { DynamicModule } from "@nestjs/common";
+/**
+ * Options for {@link GraphExecutionModule.forRoot}.
+ */
+export interface GraphExecutionModuleOptions {
+    /**
+     * User identifier passed to the RamAdapter. Defaults to `"graph-engine"`.
+     */
+    adapterUser?: string;
+    /**
+     * When `true`, calls `RamAdapter.decoration()` and
+     * `Adapter.setCurrent(RamFlavour)` during module initialisation. Defaults to
+     * `true`. Set to `false` when the host application has already configured a
+     * RamAdapter.
+     */
+    initAdapter?: boolean;
+}
+/**
+ * NestJS module that hosts the graph execution engine server-side.
+ *
+ * Provides:
+ * - {@link GraphExecutionEngine} — singleton engine with a demo executor registry.
+ * - `GRAPH_RESULT_REPOSITORY` — Decaf repository for {@link GraphExecutionResultModel} backed by RamAdapter.
+ * - {@link GraphExecutionController} — REST + SSE controller.
+ */
+export declare class GraphExecutionModule {
+    /**
+     * Creates a configured {@link DynamicModule} for the graph execution backend.
+     *
+     * @param options - Module configuration options.
+     * @returns A NestJS `DynamicModule` ready for import.
+     */
+    static forRoot(options?: GraphExecutionModuleOptions): DynamicModule;
+}

package/lib/types/nest/graph/GraphExecutionResultModel.d.cts

@@ -0,0 +1,46 @@
+/**
+ * @module integrations/nest/graph/GraphExecutionResultModel
+ * @summary Decaf model for persisting graph execution results.
+ * @description Serializes a {@link GraphExecutionResult} for storage in a Decaf persistence adapter (e.g. RamAdapter). Stores the run id, workflow id, status, inputs, outputs, per-node results, and timing information so clients can retrieve a completed run's full state via `GET /graph/results/:runId`.
+ */
+import { Model, type ModelArg } from "@decaf-ts/decorator-validation";
+/**
+ * Persisted representation of a completed graph execution run.
+ *
+ * Stored in the `graph_execution_result` table and keyed by `runId`.
+ */
+export declare class GraphExecutionResultModel extends Model {
+    /**
+     * Unique identifier for this execution run. Acts as the primary key.
+     */
+    runId: string;
+    /**
+     * Identifier of the workflow that was executed.
+     */
+    workflowId: string;
+    /**
+     * Final status of the run (e.g. `succeeded`, `failed`).
+     */
+    status: string;
+    /**
+     * Inputs supplied to the workflow at execution time.
+     */
+    inputs: Record<string, unknown>;
+    /**
+     * Outputs produced by the workflow.
+     */
+    outputs: Record<string, unknown>;
+    /**
+     * Per-node execution results keyed by node id.
+     */
+    nodeResults: Record<string, unknown>;
+    /**
+     * Timestamp marking when the run started.
+     */
+    startedAt: Date;
+    /**
+     * Timestamp marking when the run finished.
+     */
+    finishedAt?: Date;
+    constructor(arg?: ModelArg<GraphExecutionResultModel>);
+}

package/lib/types/nest/graph/GraphExecutionResultModel.d.mts

@@ -0,0 +1,46 @@
+/**
+ * @module integrations/nest/graph/GraphExecutionResultModel
+ * @summary Decaf model for persisting graph execution results.
+ * @description Serializes a {@link GraphExecutionResult} for storage in a Decaf persistence adapter (e.g. RamAdapter). Stores the run id, workflow id, status, inputs, outputs, per-node results, and timing information so clients can retrieve a completed run's full state via `GET /graph/results/:runId`.
+ */
+import { Model, type ModelArg } from "@decaf-ts/decorator-validation";
+/**
+ * Persisted representation of a completed graph execution run.
+ *
+ * Stored in the `graph_execution_result` table and keyed by `runId`.
+ */
+export declare class GraphExecutionResultModel extends Model {
+    /**
+     * Unique identifier for this execution run. Acts as the primary key.
+     */
+    runId: string;
+    /**
+     * Identifier of the workflow that was executed.
+     */
+    workflowId: string;
+    /**
+     * Final status of the run (e.g. `succeeded`, `failed`).
+     */
+    status: string;
+    /**
+     * Inputs supplied to the workflow at execution time.
+     */
+    inputs: Record<string, unknown>;
+    /**
+     * Outputs produced by the workflow.
+     */
+    outputs: Record<string, unknown>;
+    /**
+     * Per-node execution results keyed by node id.
+     */
+    nodeResults: Record<string, unknown>;
+    /**
+     * Timestamp marking when the run started.
+     */
+    startedAt: Date;
+    /**
+     * Timestamp marking when the run finished.
+     */
+    finishedAt?: Date;
+    constructor(arg?: ModelArg<GraphExecutionResultModel>);
+}