@decaf-ts/integrations 0.6.2 → 0.8.0

package/lib/types/graph/shared/types.d.cts

@@ -2,13 +2,15 @@
  * @module integrations/graph/shared/types
  * @summary Frontend-safe graph type declarations.
  * @description Type aliases and interfaces that are safe to import from a
- * frontend bundle. These types describe declarative graph metadata (loop
- * condition DSL, switch cases, node metadata patches) and the execution-event
- * data contract consumed by the frontend via SSE — no engine runtime
- * dependency.
+ * frontend bundle. Alongside the declarative graph metadata types (loop
+ * condition DSL, switch cases, node metadata patches), this module carries the
+ * DECAF-48 execution contract consumed by the frontend via SSE: the node/edge
+ * state-change payloads, the structured run log entry, the node I/O
+ * inspection payload, the run-scoped subscription ownership tuple, and the
+ * Log-node level. All consumed over SSE — no engine runtime dependency.
  */
 import type { GraphPortDefinition } from "@decaf-ts/ui-decorators/graph";
-import type { GraphExecutionEventType, GraphExecutionStatus } from "./constants.d.cts";
+import type { GraphExecutionEventType, GraphExecutionStatus, GraphVisualState } from "./constants.d.cts";
 /**
  * A value reference inside a {@link ConditionExpression}.
  *
@@ -166,3 +168,90 @@ export interface GraphExecutionEvent {
     error?: GraphExecutionErrorPayload;
     metadata?: Record<string, unknown>;
 }
+/**
+ * Payload carried by `NODE_STATE_CHANGED` events (DECAF-48 §4.4).
+ *
+ * The visual state is the engine-agnostic contract a Mastra/NestJS driver
+ * MUST emit; the reference engine derives it from its own execution events.
+ */
+export interface GraphNodeStateChangedPayload {
+    nodeId: string;
+    state: GraphVisualState;
+    runId: string;
+    workflowId: string;
+    /** Engine status that produced the visual state (when available). */
+    status?: GraphExecutionStatus;
+    iteration?: number;
+}
+/**
+ * Payload carried by `EDGE_STATE_CHANGED` events (DECAF-48 §4.4).
+ */
+export interface GraphEdgeStateChangedPayload {
+    edgeId: string;
+    state: GraphVisualState;
+    runId: string;
+    workflowId: string;
+    /** Source node of the routed edge (when available). */
+    nodeId?: string;
+    /** Engine status that produced the visual state (when available). */
+    status?: GraphExecutionStatus;
+}
+/**
+ * Structured log line streamed over the `graph.run.log` SSE channel
+ * (DECAF-48 §4.3). Serialized from the run's `ctx.logger` output; the level
+ * drives the Chrome-console-style filter while the attributes render as
+ * discrete columns.
+ */
+export interface GraphRunLogEntry {
+    /** Log severity level driving the Chrome-console-style widget filter (all `LogNodeLevel` values plus `benchmark`). */
+    level: "silly" | "trace" | "debug" | "verbose" | "info" | "warn" | "error" | "critical" | "fatal" | "benchmark";
+    message: string;
+    timestamp: string;
+    runId: string;
+    workflowId: string;
+    nodeId?: string;
+    user?: string | null;
+    /** Structured payload associated with the log line, if any. */
+    payload?: unknown;
+}
+/**
+ * Structured per-node I/O payload exposed for node inspection (DECAF-48 §4.6).
+ *
+ * Frontend-safe: pure data delivered via `graph/shared` types over the SSE
+ * state channel (or a `GET /graph/results/:runId` lookup); the frontend
+ * renders both panes (inputs right, outputs/error left) from this one shape.
+ */
+export interface GraphNodeInspectionPayload {
+    runId: string;
+    workflowId: string;
+    nodeId: string;
+    state: GraphVisualState;
+    inputs: Record<string, unknown>;
+    /** Present when SUCCEEDED (or from cache). */
+    outputs?: Record<string, unknown>;
+    /** Present when FAILED. */
+    error?: GraphExecutionErrorPayload;
+}
+/**
+ * Log levels accepted by the Log node (DECAF-48 §4.3).
+ *
+ * Mirrors the DECAF-9 log level set so the Log node executor (and the
+ * {@link GraphRunLogger} dispatch) can forward onto the run's `ctx.logger`.
+ * Includes every level rendered by the Chrome-console-style widget filter.
+ */
+export type LogNodeLevel = "silly" | "trace" | "debug" | "verbose" | "info" | "warn" | "error" | "critical" | "fatal";
+/**
+ * Run-scoped SSE subscription ownership key (DECAF-48 §4.2).
+ *
+ * Subscription-mode SSE is keyed by run ownership: a consumer is only
+ * delivered graph events/logs for runs it owns. This tuple is the
+ * engine-agnostic contract a Mastra/NestJS driver MUST honour —
+ * `runId` together with the owning `user` (or a `system` runner when the
+ * identity is absent) scope every `graph.run.*` event before `next(...)`.
+ */
+export interface GraphRunSubscription {
+    runId: string;
+    ownerUser: string | null;
+    /** Optional topic filter (e.g. `graph.run.log`, `graph.run.state`). */
+    topics?: string[];
+}

package/lib/types/graph/shared/types.d.mts

@@ -2,13 +2,15 @@
  * @module integrations/graph/shared/types
  * @summary Frontend-safe graph type declarations.
  * @description Type aliases and interfaces that are safe to import from a
- * frontend bundle. These types describe declarative graph metadata (loop
- * condition DSL, switch cases, node metadata patches) and the execution-event
- * data contract consumed by the frontend via SSE — no engine runtime
- * dependency.
+ * frontend bundle. Alongside the declarative graph metadata types (loop
+ * condition DSL, switch cases, node metadata patches), this module carries the
+ * DECAF-48 execution contract consumed by the frontend via SSE: the node/edge
+ * state-change payloads, the structured run log entry, the node I/O
+ * inspection payload, the run-scoped subscription ownership tuple, and the
+ * Log-node level. All consumed over SSE — no engine runtime dependency.
  */
 import type { GraphPortDefinition } from "@decaf-ts/ui-decorators/graph";
-import type { GraphExecutionEventType, GraphExecutionStatus } from "./constants.d.mts";
+import type { GraphExecutionEventType, GraphExecutionStatus, GraphVisualState } from "./constants.d.mts";
 /**
  * A value reference inside a {@link ConditionExpression}.
  *
@@ -166,3 +168,90 @@ export interface GraphExecutionEvent {
     error?: GraphExecutionErrorPayload;
     metadata?: Record<string, unknown>;
 }
+/**
+ * Payload carried by `NODE_STATE_CHANGED` events (DECAF-48 §4.4).
+ *
+ * The visual state is the engine-agnostic contract a Mastra/NestJS driver
+ * MUST emit; the reference engine derives it from its own execution events.
+ */
+export interface GraphNodeStateChangedPayload {
+    nodeId: string;
+    state: GraphVisualState;
+    runId: string;
+    workflowId: string;
+    /** Engine status that produced the visual state (when available). */
+    status?: GraphExecutionStatus;
+    iteration?: number;
+}
+/**
+ * Payload carried by `EDGE_STATE_CHANGED` events (DECAF-48 §4.4).
+ */
+export interface GraphEdgeStateChangedPayload {
+    edgeId: string;
+    state: GraphVisualState;
+    runId: string;
+    workflowId: string;
+    /** Source node of the routed edge (when available). */
+    nodeId?: string;
+    /** Engine status that produced the visual state (when available). */
+    status?: GraphExecutionStatus;
+}
+/**
+ * Structured log line streamed over the `graph.run.log` SSE channel
+ * (DECAF-48 §4.3). Serialized from the run's `ctx.logger` output; the level
+ * drives the Chrome-console-style filter while the attributes render as
+ * discrete columns.
+ */
+export interface GraphRunLogEntry {
+    /** Log severity level driving the Chrome-console-style widget filter (all `LogNodeLevel` values plus `benchmark`). */
+    level: "silly" | "trace" | "debug" | "verbose" | "info" | "warn" | "error" | "critical" | "fatal" | "benchmark";
+    message: string;
+    timestamp: string;
+    runId: string;
+    workflowId: string;
+    nodeId?: string;
+    user?: string | null;
+    /** Structured payload associated with the log line, if any. */
+    payload?: unknown;
+}
+/**
+ * Structured per-node I/O payload exposed for node inspection (DECAF-48 §4.6).
+ *
+ * Frontend-safe: pure data delivered via `graph/shared` types over the SSE
+ * state channel (or a `GET /graph/results/:runId` lookup); the frontend
+ * renders both panes (inputs right, outputs/error left) from this one shape.
+ */
+export interface GraphNodeInspectionPayload {
+    runId: string;
+    workflowId: string;
+    nodeId: string;
+    state: GraphVisualState;
+    inputs: Record<string, unknown>;
+    /** Present when SUCCEEDED (or from cache). */
+    outputs?: Record<string, unknown>;
+    /** Present when FAILED. */
+    error?: GraphExecutionErrorPayload;
+}
+/**
+ * Log levels accepted by the Log node (DECAF-48 §4.3).
+ *
+ * Mirrors the DECAF-9 log level set so the Log node executor (and the
+ * {@link GraphRunLogger} dispatch) can forward onto the run's `ctx.logger`.
+ * Includes every level rendered by the Chrome-console-style widget filter.
+ */
+export type LogNodeLevel = "silly" | "trace" | "debug" | "verbose" | "info" | "warn" | "error" | "critical" | "fatal";
+/**
+ * Run-scoped SSE subscription ownership key (DECAF-48 §4.2).
+ *
+ * Subscription-mode SSE is keyed by run ownership: a consumer is only
+ * delivered graph events/logs for runs it owns. This tuple is the
+ * engine-agnostic contract a Mastra/NestJS driver MUST honour —
+ * `runId` together with the owning `user` (or a `system` runner when the
+ * identity is absent) scope every `graph.run.*` event before `next(...)`.
+ */
+export interface GraphRunSubscription {
+    runId: string;
+    ownerUser: string | null;
+    /** Optional topic filter (e.g. `graph.run.log`, `graph.run.state`). */
+    topics?: string[];
+}

package/lib/types/index.d.cts

@@ -7,6 +7,6 @@ export * from "./utils.d.cts";
 export * from "./namespaces/index.d.cts";
 export * from "./feature-flags/index.d.cts";
 export declare const VERSION: string;
-export declare const COMMIT = "2638fa3";
-export declare const FULL_VERSION = "0.6.1-2638fa3";
+export declare const COMMIT = "2a891e0";
+export declare const FULL_VERSION = "0.7.0-2a891e0";
 export declare const PACKAGE_NAME: string;

package/lib/types/index.d.mts

@@ -7,6 +7,6 @@ export * from "./utils.d.mts";
 export * from "./namespaces/index.d.mts";
 export * from "./feature-flags/index.d.mts";
 export declare const VERSION: string;
-export declare const COMMIT = "2638fa3";
-export declare const FULL_VERSION = "0.6.1-2638fa3";
+export declare const COMMIT = "2a891e0";
+export declare const FULL_VERSION = "0.7.0-2a891e0";
 export declare const PACKAGE_NAME: string;

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

@@ -1,5 +1,5 @@
-import { Model, type ModelArg } from "@decaf-ts/decorator-validation";
-export declare class GraphExecutionResultModel extends Model {
+import { BaseModel } from "@decaf-ts/core";
+export declare class GraphExecutionResultModel extends BaseModel {
     runId: string;
     workflowId: string;
     status: string;
@@ -8,5 +8,5 @@ export declare class GraphExecutionResultModel extends Model {
     nodeResults: Record<string, unknown>;
     startedAt: Date;
     finishedAt?: Date;
-    constructor(arg?: ModelArg<GraphExecutionResultModel>);
+    constructor(arg?: Partial<GraphExecutionResultModel>);
 }

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

@@ -1,5 +1,5 @@
-import { Model, type ModelArg } from "@decaf-ts/decorator-validation";
-export declare class GraphExecutionResultModel extends Model {
+import { BaseModel } from "@decaf-ts/core";
+export declare class GraphExecutionResultModel extends BaseModel {
     runId: string;
     workflowId: string;
     status: string;
@@ -8,5 +8,5 @@ export declare class GraphExecutionResultModel extends Model {
     nodeResults: Record<string, unknown>;
     startedAt: Date;
     finishedAt?: Date;
-    constructor(arg?: ModelArg<GraphExecutionResultModel>);
+    constructor(arg?: Partial<GraphExecutionResultModel>);
 }

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

@@ -4,9 +4,9 @@
  * @description Creates a registry pre-loaded with the demo executors used by
  * the graph execution backend's sample workflows. The executors cover the
  * flow-control kinds (including Code, Log, and Switch with code conditions),
- * the agent kind, and the loop kinds. Additional executors can be registered
- * on the returned registry before it is handed to the
- * {@link GraphExecutionEngine}.
+ * the DECAF-48 `core.utility.log` Log node, the agent kind, and the loop
+ * kinds. Additional executors can be registered on the returned registry
+ * before it is handed to the {@link GraphExecutionEngine}.
  */
 import { GraphNodeExecutorRegistry, GraphExecutionEngine, type GraphNodeExecutor, IsolatedVmCodeSandboxEvaluator } from "../../graph/index.d.cts";
 /**

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

@@ -4,9 +4,9 @@
  * @description Creates a registry pre-loaded with the demo executors used by
  * the graph execution backend's sample workflows. The executors cover the
  * flow-control kinds (including Code, Log, and Switch with code conditions),
- * the agent kind, and the loop kinds. Additional executors can be registered
- * on the returned registry before it is handed to the
- * {@link GraphExecutionEngine}.
+ * the DECAF-48 `core.utility.log` Log node, the agent kind, and the loop
+ * kinds. Additional executors can be registered on the returned registry
+ * before it is handed to the {@link GraphExecutionEngine}.
  */
 import { GraphNodeExecutorRegistry, GraphExecutionEngine, type GraphNodeExecutor, IsolatedVmCodeSandboxEvaluator } from "../../graph/index.d.mts";
 /**

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

@@ -1,7 +1,6 @@
-import { Model, type ModelArg } from "@decaf-ts/decorator-validation";
-export declare class GraphWorkflowModel extends Model {
+import { BaseModel } from "@decaf-ts/core";
+export declare class GraphWorkflowModel extends BaseModel {
     workflowId: string;
     snapshot: Record<string, unknown>;
-    updatedAt: Date;
-    constructor(arg?: ModelArg<GraphWorkflowModel>);
+    constructor(arg?: Partial<GraphWorkflowModel>);
 }

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

@@ -1,7 +1,6 @@
-import { Model, type ModelArg } from "@decaf-ts/decorator-validation";
-export declare class GraphWorkflowModel extends Model {
+import { BaseModel } from "@decaf-ts/core";
+export declare class GraphWorkflowModel extends BaseModel {
     workflowId: string;
     snapshot: Record<string, unknown>;
-    updatedAt: Date;
-    constructor(arg?: ModelArg<GraphWorkflowModel>);
+    constructor(arg?: Partial<GraphWorkflowModel>);
 }

package/lib/types/sftp/aws/AwsSftpService.d.cts

@@ -0,0 +1,37 @@
+import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+import { SftpSource, type SftpFileEntry, type SftpFileResult, type SftpSourceConfig } from "../core/SftpSource.d.cts";
+export interface AwsTransferSftpConfig extends SftpSourceConfig {
+    provider: "aws-transfer";
+    region: string;
+    bucket: string;
+    s3Prefix?: string;
+    serverId?: string;
+}
+interface S3ListObjectsV2Output {
+    Contents?: Array<{
+        Key?: string;
+        Size?: number;
+        LastModified?: Date;
+    }>;
+    NextContinuationToken?: string;
+}
+interface S3LikeClient {
+    listObjectsV2(params: unknown): Promise<S3ListObjectsV2Output>;
+    getObject(params: unknown): Promise<{
+        body: AsyncIterable<Uint8Array>;
+    }>;
+    deleteObject(params: unknown): Promise<unknown>;
+}
+export declare class AwsSftpService extends SftpSource<S3LikeClient, AwsTransferSftpConfig> {
+    constructor();
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: AwsTransferSftpConfig;
+        client: S3LikeClient;
+    }>;
+    private s3Prefix;
+    list(remoteDir?: string, ...args: MaybeContextualArg<any>): Promise<SftpFileEntry[]>;
+    fetch(remotePath: string, ...args: MaybeContextualArg<any>): Promise<SftpFileResult>;
+    delete(remotePath: string, ...args: MaybeContextualArg<any>): Promise<void>;
+    close(...args: MaybeContextualArg<any>): Promise<void>;
+}
+export {};

package/lib/types/sftp/aws/AwsSftpService.d.mts

@@ -0,0 +1,37 @@
+import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+import { SftpSource, type SftpFileEntry, type SftpFileResult, type SftpSourceConfig } from "../core/SftpSource.d.mts";
+export interface AwsTransferSftpConfig extends SftpSourceConfig {
+    provider: "aws-transfer";
+    region: string;
+    bucket: string;
+    s3Prefix?: string;
+    serverId?: string;
+}
+interface S3ListObjectsV2Output {
+    Contents?: Array<{
+        Key?: string;
+        Size?: number;
+        LastModified?: Date;
+    }>;
+    NextContinuationToken?: string;
+}
+interface S3LikeClient {
+    listObjectsV2(params: unknown): Promise<S3ListObjectsV2Output>;
+    getObject(params: unknown): Promise<{
+        body: AsyncIterable<Uint8Array>;
+    }>;
+    deleteObject(params: unknown): Promise<unknown>;
+}
+export declare class AwsSftpService extends SftpSource<S3LikeClient, AwsTransferSftpConfig> {
+    constructor();
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: AwsTransferSftpConfig;
+        client: S3LikeClient;
+    }>;
+    private s3Prefix;
+    list(remoteDir?: string, ...args: MaybeContextualArg<any>): Promise<SftpFileEntry[]>;
+    fetch(remotePath: string, ...args: MaybeContextualArg<any>): Promise<SftpFileResult>;
+    delete(remotePath: string, ...args: MaybeContextualArg<any>): Promise<void>;
+    close(...args: MaybeContextualArg<any>): Promise<void>;
+}
+export {};

package/lib/types/sftp/core/SftpSource.d.cts

@@ -0,0 +1,40 @@
+import { ClientBasedService, type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+export type SftpProvider = "ssh2" | "aws-transfer";
+export interface SftpSourceConfig {
+    provider: SftpProvider;
+    sourceId: string;
+    host: string;
+    port?: number;
+    username: string;
+    password?: string;
+    privateKey?: string;
+    passphrase?: string;
+    remotePath?: string;
+}
+export interface SftpFileEntry {
+    path: string;
+    name: string;
+    size: number;
+    modifyTime: number;
+    isDirectory: boolean;
+}
+export interface SftpFileResult {
+    path: string;
+    name: string;
+    content: Buffer;
+    size: number;
+}
+export declare abstract class SftpSource<TClient = unknown, TConfig extends SftpSourceConfig = SftpSourceConfig> extends ClientBasedService<TClient, TConfig> {
+    constructor();
+    get provider(): SftpProvider;
+    get sourceId(): string;
+    abstract initialize(...args: ContextualArgs<any>): Promise<{
+        config: TConfig;
+        client: TClient;
+    }>;
+    abstract list(remoteDir?: string, ...args: MaybeContextualArg<any>): Promise<SftpFileEntry[]>;
+    abstract fetch(remotePath: string, ...args: MaybeContextualArg<any>): Promise<SftpFileResult>;
+    abstract delete(remotePath: string, ...args: MaybeContextualArg<any>): Promise<void>;
+    abstract close(...args: MaybeContextualArg<any>): Promise<void>;
+}
+export declare function assertSftpConfig(config: SftpSourceConfig): void;

package/lib/types/sftp/core/SftpSource.d.mts

@@ -0,0 +1,40 @@
+import { ClientBasedService, type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+export type SftpProvider = "ssh2" | "aws-transfer";
+export interface SftpSourceConfig {
+    provider: SftpProvider;
+    sourceId: string;
+    host: string;
+    port?: number;
+    username: string;
+    password?: string;
+    privateKey?: string;
+    passphrase?: string;
+    remotePath?: string;
+}
+export interface SftpFileEntry {
+    path: string;
+    name: string;
+    size: number;
+    modifyTime: number;
+    isDirectory: boolean;
+}
+export interface SftpFileResult {
+    path: string;
+    name: string;
+    content: Buffer;
+    size: number;
+}
+export declare abstract class SftpSource<TClient = unknown, TConfig extends SftpSourceConfig = SftpSourceConfig> extends ClientBasedService<TClient, TConfig> {
+    constructor();
+    get provider(): SftpProvider;
+    get sourceId(): string;
+    abstract initialize(...args: ContextualArgs<any>): Promise<{
+        config: TConfig;
+        client: TClient;
+    }>;
+    abstract list(remoteDir?: string, ...args: MaybeContextualArg<any>): Promise<SftpFileEntry[]>;
+    abstract fetch(remotePath: string, ...args: MaybeContextualArg<any>): Promise<SftpFileResult>;
+    abstract delete(remotePath: string, ...args: MaybeContextualArg<any>): Promise<void>;
+    abstract close(...args: MaybeContextualArg<any>): Promise<void>;
+}
+export declare function assertSftpConfig(config: SftpSourceConfig): void;

package/lib/types/sftp/core/index.d.cts

@@ -0,0 +1 @@
+export * from "./SftpSource.d.cts";

package/lib/types/sftp/core/index.d.mts

@@ -0,0 +1 @@
+export * from "./SftpSource.d.mts";

package/lib/types/sftp/index.d.cts

@@ -0,0 +1,3 @@
+export * from "./ssh2/Ssh2SftpService.d.cts";
+export * from "./aws/AwsSftpService.d.cts";
+export * from "./core/SftpSource.d.cts";

package/lib/types/sftp/index.d.mts

@@ -0,0 +1,3 @@
+export * from "./ssh2/Ssh2SftpService.d.mts";
+export * from "./aws/AwsSftpService.d.mts";
+export * from "./core/SftpSource.d.mts";

package/lib/types/sftp/ssh2/Ssh2SftpService.d.cts

@@ -0,0 +1,47 @@
+import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+import { SftpSource, type SftpFileEntry, type SftpFileResult, type SftpSourceConfig } from "../core/SftpSource.d.cts";
+export interface Ssh2SftpConfig extends SftpSourceConfig {
+    provider: "ssh2";
+    readyTimeout?: number;
+}
+interface Ssh2Client {
+    connect(config: unknown): void;
+    on(event: "ready", cb: () => void): void;
+    on(event: "error", cb: (err: Error) => void): void;
+    sftp(cb: (err: Error | null, sftp: Ssh2SftpHandle) => void): void;
+    end(): void;
+}
+interface Ssh2SftpHandle {
+    readdir(dir: string, cb: (err: Error | null, list: Array<{
+        filename: string;
+        attrs: {
+            size: number;
+            mtime: number;
+            mode: number;
+        };
+    }>) => void): void;
+    stat(path: string, cb: (err: Error | null, stat: {
+        size: number;
+        mtime: number;
+        mode: number;
+    }) => void): void;
+    open(path: string, flags: string, cb: (err: Error | null, handle: Buffer) => void): void;
+    read(handle: Buffer, buffer: Buffer, offset: number, length: number, position: number, cb: (err: Error | null, bytesRead: number, buffer: Buffer) => void): void;
+    close(handle: Buffer, cb: (err: Error | null) => void): void;
+    unlink(path: string, cb: (err: Error | null) => void): void;
+    end(cb?: () => void): void;
+}
+export declare class Ssh2SftpService extends SftpSource<Ssh2Client, Ssh2SftpConfig> {
+    private sftp?;
+    constructor();
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: Ssh2SftpConfig;
+        client: Ssh2Client;
+    }>;
+    list(remoteDir?: string, ...args: MaybeContextualArg<any>): Promise<SftpFileEntry[]>;
+    fetch(remotePath: string, ...args: MaybeContextualArg<any>): Promise<SftpFileResult>;
+    delete(remotePath: string, ...args: MaybeContextualArg<any>): Promise<void>;
+    close(...args: MaybeContextualArg<any>): Promise<void>;
+    private requireSftp;
+}
+export {};

package/lib/types/sftp/ssh2/Ssh2SftpService.d.mts

@@ -0,0 +1,47 @@
+import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+import { SftpSource, type SftpFileEntry, type SftpFileResult, type SftpSourceConfig } from "../core/SftpSource.d.mts";
+export interface Ssh2SftpConfig extends SftpSourceConfig {
+    provider: "ssh2";
+    readyTimeout?: number;
+}
+interface Ssh2Client {
+    connect(config: unknown): void;
+    on(event: "ready", cb: () => void): void;
+    on(event: "error", cb: (err: Error) => void): void;
+    sftp(cb: (err: Error | null, sftp: Ssh2SftpHandle) => void): void;
+    end(): void;
+}
+interface Ssh2SftpHandle {
+    readdir(dir: string, cb: (err: Error | null, list: Array<{
+        filename: string;
+        attrs: {
+            size: number;
+            mtime: number;
+            mode: number;
+        };
+    }>) => void): void;
+    stat(path: string, cb: (err: Error | null, stat: {
+        size: number;
+        mtime: number;
+        mode: number;
+    }) => void): void;
+    open(path: string, flags: string, cb: (err: Error | null, handle: Buffer) => void): void;
+    read(handle: Buffer, buffer: Buffer, offset: number, length: number, position: number, cb: (err: Error | null, bytesRead: number, buffer: Buffer) => void): void;
+    close(handle: Buffer, cb: (err: Error | null) => void): void;
+    unlink(path: string, cb: (err: Error | null) => void): void;
+    end(cb?: () => void): void;
+}
+export declare class Ssh2SftpService extends SftpSource<Ssh2Client, Ssh2SftpConfig> {
+    private sftp?;
+    constructor();
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: Ssh2SftpConfig;
+        client: Ssh2Client;
+    }>;
+    list(remoteDir?: string, ...args: MaybeContextualArg<any>): Promise<SftpFileEntry[]>;
+    fetch(remotePath: string, ...args: MaybeContextualArg<any>): Promise<SftpFileResult>;
+    delete(remotePath: string, ...args: MaybeContextualArg<any>): Promise<void>;
+    close(...args: MaybeContextualArg<any>): Promise<void>;
+    private requireSftp;
+}
+export {};

package/lib/types/user-requests/index.d.cts

@@ -0,0 +1,9 @@
+/**
+ * @module integrations/user-requests
+ * @summary User Request Resolution Engine surface exported to integrations
+ * consumers.
+ * @description Re-exports the `@decaf-ts/ui-decorators/user-requests` barrel so
+ * integrations packages can hand user-request handling to app consumers
+ * through a flat entry point.
+ */
+export * from '@decaf-ts/ui-decorators/user-requests';

package/lib/types/user-requests/index.d.mts

@@ -0,0 +1,9 @@
+/**
+ * @module integrations/user-requests
+ * @summary User Request Resolution Engine surface exported to integrations
+ * consumers.
+ * @description Re-exports the `@decaf-ts/ui-decorators/user-requests` barrel so
+ * integrations packages can hand user-request handling to app consumers
+ * through a flat entry point.
+ */
+export * from '@decaf-ts/ui-decorators/user-requests';