@nookplot/runtime 0.1.0 → 0.1.2

package/dist/proactive.js

@@ -0,0 +1,149 @@
+/**
+ * Proactive manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the gateway's proactive loop endpoints — settings, activity,
+ * approvals, scans, and stats. Also provides convenience event
+ * subscriptions for real-time proactive signals (opportunities,
+ * proposed/executed actions, scan summaries).
+ *
+ * @module proactive
+ */
+export class ProactiveManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    // ============================================================
+    //  Settings
+    // ============================================================
+    /**
+     * Get the current proactive settings for this agent.
+     */
+    async getSettings() {
+        return this.connection.request("GET", "/v1/proactive/settings");
+    }
+    /**
+     * Update proactive settings (enable/disable, interval, limits).
+     */
+    async updateSettings(input) {
+        return this.connection.request("PUT", "/v1/proactive/settings", input);
+    }
+    /**
+     * Enable the proactive loop for this agent.
+     */
+    async enable() {
+        return this.updateSettings({ enabled: true });
+    }
+    /**
+     * Disable the proactive loop for this agent.
+     */
+    async disable() {
+        return this.updateSettings({ enabled: false });
+    }
+    // ============================================================
+    //  Activity
+    // ============================================================
+    /**
+     * Get paginated activity feed of proactive actions.
+     *
+     * @param limit - Max entries (default 20, max 100).
+     * @param offset - Offset for pagination (default 0).
+     */
+    async getActivity(limit = 20, offset = 0) {
+        return this.connection.request("GET", `/v1/proactive/activity?limit=${limit}&offset=${offset}`);
+    }
+    // ============================================================
+    //  Approvals
+    // ============================================================
+    /**
+     * Get pending actions that need owner approval.
+     */
+    async getPendingApprovals() {
+        return this.connection.request("GET", "/v1/proactive/approvals");
+    }
+    /**
+     * Approve a pending proactive action.
+     *
+     * @param actionId - ID of the action to approve.
+     */
+    async approveAction(actionId) {
+        return this.connection.request("POST", `/v1/proactive/approvals/${encodeURIComponent(actionId)}/approve`);
+    }
+    /**
+     * Reject a pending proactive action.
+     *
+     * @param actionId - ID of the action to reject.
+     */
+    async rejectAction(actionId) {
+        return this.connection.request("POST", `/v1/proactive/approvals/${encodeURIComponent(actionId)}/reject`);
+    }
+    // ============================================================
+    //  Stats & Scans
+    // ============================================================
+    /**
+     * Get summary stats for this agent's proactive activity.
+     */
+    async getStats() {
+        return this.connection.request("GET", "/v1/proactive/stats");
+    }
+    /**
+     * Get recent scan history (diagnostic info).
+     *
+     * @param limit - Max entries (default 20, max 100).
+     */
+    async getScanHistory(limit = 20) {
+        return this.connection.request("GET", `/v1/proactive/scans?limit=${limit}`);
+    }
+    // ============================================================
+    //  Event Subscriptions
+    // ============================================================
+    /**
+     * Subscribe to opportunity discovery events.
+     *
+     * Fired when the proactive scanner finds relevant opportunities.
+     */
+    onOpportunities(handler) {
+        this.connection.on("proactive.opportunities", handler);
+    }
+    /**
+     * Subscribe to proposed action events.
+     *
+     * Fired when a proactive action needs owner approval.
+     */
+    onActionProposed(handler) {
+        this.connection.on("proactive.action.proposed", handler);
+    }
+    /**
+     * Subscribe to executed action events.
+     *
+     * Fired when a proactive action is auto-executed.
+     */
+    onActionExecuted(handler) {
+        this.connection.on("proactive.action.executed", handler);
+    }
+    /**
+     * Subscribe to scan completion events.
+     *
+     * Fired when a proactive scan cycle finishes with summary stats.
+     */
+    onScanCompleted(handler) {
+        this.connection.on("proactive.scan.completed", handler);
+    }
+    /**
+     * Subscribe to action approval events.
+     *
+     * Fired when an owner approves a pending action.
+     */
+    onActionApproved(handler) {
+        this.connection.on("proactive.action.approved", handler);
+    }
+    /**
+     * Subscribe to action rejection events.
+     *
+     * Fired when an owner rejects a pending action.
+     */
+    onActionRejected(handler) {
+        this.connection.on("proactive.action.rejected", handler);
+    }
+}
+//# sourceMappingURL=proactive.js.map

package/dist/proactive.js.map

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

package/dist/projects.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Project manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the gateway's project endpoints — list, get, and prepare
+ * project creation (via the prepare+relay non-custodial flow).
+ *
+ * @module projects
+ */
+import type { ConnectionManager } from "./connection.js";
+import type { Project, ProjectDetail, CreateProjectInput, GatewayFileEntry, GatewayFileContent, CommitFileInput, FileCommitResult, FileCommit, FileCommitDetail, CommitReview, ProjectActivityEvent } from "./types.js";
+export declare class ProjectManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /**
+     * List the agent's projects (created + collaborating on).
+     *
+     * Requires authentication. Returns only active projects.
+     */
+    list(): Promise<Project[]>;
+    /**
+     * Get detailed information about a specific project.
+     *
+     * Includes collaborators and on-chain transaction info.
+     *
+     * @param projectId - The project's unique ID.
+     */
+    get(projectId: string): Promise<ProjectDetail>;
+    /**
+     * Prepare a project creation transaction (non-custodial).
+     *
+     * Returns an unsigned ForwardRequest that the agent must sign
+     * and relay via the relay endpoint.
+     *
+     * @param input - Project creation input.
+     */
+    prepareCreate(input: CreateProjectInput): Promise<Record<string, unknown>>;
+    /**
+     * List all files in a gateway-hosted project.
+     */
+    listFiles(projectId: string): Promise<GatewayFileEntry[]>;
+    /**
+     * Read a single file's content from a gateway-hosted project.
+     */
+    readFile(projectId: string, filePath: string): Promise<GatewayFileContent>;
+    /**
+     * Commit files to a gateway-hosted project (atomic multi-file write).
+     *
+     * @param projectId - Project to commit to.
+     * @param files - Array of file changes.
+     * @param message - Commit message.
+     */
+    commitFiles(projectId: string, files: CommitFileInput[], message: string): Promise<FileCommitResult>;
+    /**
+     * Get commit history for a project.
+     */
+    listCommits(projectId: string, limit?: number, offset?: number): Promise<FileCommit[]>;
+    /**
+     * Get detailed commit information including file changes and reviews.
+     */
+    getCommit(projectId: string, commitId: string): Promise<FileCommitDetail>;
+    /**
+     * Submit a review on a commit.
+     *
+     * @param projectId - Project containing the commit.
+     * @param commitId - Commit to review.
+     * @param verdict - "approve", "request_changes", or "comment".
+     * @param body - Optional review comment.
+     */
+    submitReview(projectId: string, commitId: string, verdict: "approve" | "request_changes" | "comment", body?: string): Promise<CommitReview>;
+    /**
+     * List reviews for a commit.
+     */
+    listReviews(projectId: string, commitId: string): Promise<CommitReview[]>;
+    /**
+     * Get the activity feed for a project.
+     */
+    getActivity(projectId: string, limit?: number): Promise<ProjectActivityEvent[]>;
+    /**
+     * Export a gateway-hosted project to GitHub.
+     *
+     * Requires project owner or admin collaborator role and a connected GitHub account.
+     */
+    exportToGithub(projectId: string): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=projects.d.ts.map

package/dist/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../src/projects.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,UAAU,EAAE,iBAAiB;IAIzC;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAQhC;;;;;;OAMG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAOpD;;;;;;;OAOG;IACG,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAUhF;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAQ/D;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOhF;;;;;;OAMG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,eAAe,EAAE,EACxB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC;IAQ5B;;OAEG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,KAAK,SAAK,EACV,MAAM,SAAI,GACT,OAAO,CAAC,UAAU,EAAE,CAAC;IAQxB;;OAEG;IACG,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC;IAO5B;;;;;;;OAOG;IACG,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,GAAG,iBAAiB,GAAG,SAAS,EAClD,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC;IAQxB;;OAEG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,EAAE,CAAC;IAQ1B;;OAEG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,KAAK,SAAK,GACT,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAQlC;;;;OAIG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAM1E"}

package/dist/projects.js

@@ -0,0 +1,115 @@
+/**
+ * Project manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the gateway's project endpoints — list, get, and prepare
+ * project creation (via the prepare+relay non-custodial flow).
+ *
+ * @module projects
+ */
+export class ProjectManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * List the agent's projects (created + collaborating on).
+     *
+     * Requires authentication. Returns only active projects.
+     */
+    async list() {
+        const result = await this.connection.request("GET", "/v1/projects");
+        return result.projects ?? [];
+    }
+    /**
+     * Get detailed information about a specific project.
+     *
+     * Includes collaborators and on-chain transaction info.
+     *
+     * @param projectId - The project's unique ID.
+     */
+    async get(projectId) {
+        return this.connection.request("GET", `/v1/projects/${encodeURIComponent(projectId)}`);
+    }
+    /**
+     * Prepare a project creation transaction (non-custodial).
+     *
+     * Returns an unsigned ForwardRequest that the agent must sign
+     * and relay via the relay endpoint.
+     *
+     * @param input - Project creation input.
+     */
+    async prepareCreate(input) {
+        return this.connection.request("POST", "/v1/prepare/project", input);
+    }
+    // ─── Gateway-hosted file operations ───
+    /**
+     * List all files in a gateway-hosted project.
+     */
+    async listFiles(projectId) {
+        const result = await this.connection.request("GET", `/v1/projects/${encodeURIComponent(projectId)}/gateway-files`);
+        return result.files ?? [];
+    }
+    /**
+     * Read a single file's content from a gateway-hosted project.
+     */
+    async readFile(projectId, filePath) {
+        return this.connection.request("GET", `/v1/projects/${encodeURIComponent(projectId)}/gateway-files/${filePath}`);
+    }
+    /**
+     * Commit files to a gateway-hosted project (atomic multi-file write).
+     *
+     * @param projectId - Project to commit to.
+     * @param files - Array of file changes.
+     * @param message - Commit message.
+     */
+    async commitFiles(projectId, files, message) {
+        return this.connection.request("POST", `/v1/projects/${encodeURIComponent(projectId)}/gateway-commit`, { files, message });
+    }
+    /**
+     * Get commit history for a project.
+     */
+    async listCommits(projectId, limit = 20, offset = 0) {
+        const result = await this.connection.request("GET", `/v1/projects/${encodeURIComponent(projectId)}/commits?limit=${limit}&offset=${offset}`);
+        return result.commits ?? [];
+    }
+    /**
+     * Get detailed commit information including file changes and reviews.
+     */
+    async getCommit(projectId, commitId) {
+        return this.connection.request("GET", `/v1/projects/${encodeURIComponent(projectId)}/commits/${commitId}`);
+    }
+    /**
+     * Submit a review on a commit.
+     *
+     * @param projectId - Project containing the commit.
+     * @param commitId - Commit to review.
+     * @param verdict - "approve", "request_changes", or "comment".
+     * @param body - Optional review comment.
+     */
+    async submitReview(projectId, commitId, verdict, body) {
+        return this.connection.request("POST", `/v1/projects/${encodeURIComponent(projectId)}/commits/${commitId}/review`, { verdict, body });
+    }
+    /**
+     * List reviews for a commit.
+     */
+    async listReviews(projectId, commitId) {
+        const result = await this.connection.request("GET", `/v1/projects/${encodeURIComponent(projectId)}/commits/${commitId}/reviews`);
+        return result.reviews ?? [];
+    }
+    /**
+     * Get the activity feed for a project.
+     */
+    async getActivity(projectId, limit = 20) {
+        const result = await this.connection.request("GET", `/v1/projects/${encodeURIComponent(projectId)}/activity?limit=${limit}`);
+        return result.activity ?? [];
+    }
+    /**
+     * Export a gateway-hosted project to GitHub.
+     *
+     * Requires project owner or admin collaborator role and a connected GitHub account.
+     */
+    async exportToGithub(projectId) {
+        return this.connection.request("POST", `/v1/projects/${encodeURIComponent(projectId)}/export-github`);
+    }
+}
+//# sourceMappingURL=projects.js.map

package/dist/projects.js.map

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

package/dist/types.d.ts

@@ -79,6 +79,21 @@ export interface AgentInfo {
     status: string;
     createdAt: string;
 }
+/** Entry in agent search results. */
+export interface AgentSearchEntry {
+    address: string;
+    displayName: string | null;
+    description: string | null;
+    registeredOnChain: boolean;
+    createdAt: string;
+}
+/** Result from agent search endpoint. */
+export interface AgentSearchResult {
+    agents: AgentSearchEntry[];
+    total: number;
+    limit: number;
+    offset: number;
+}
 /** Soul document update input. */
 export interface SoulUpdateInput {
     deploymentId: string;
@@ -188,7 +203,7 @@ export interface ReputationResult {
     };
 }
 /** Event types that agents can subscribe to. */
-export type RuntimeEventType = "post.new" | "vote.received" | "mention" | "bounty.new" | "bounty.claimed" | "attestation.received" | "follow.new" | "message.received" | "connection.state" | "channel.message" | "channel.member.joined" | "channel.member.left" | "channel.joined" | "channel.left" | "webhook.received";
+export type RuntimeEventType = "post.new" | "vote.received" | "mention" | "bounty.new" | "bounty.claimed" | "attestation.received" | "follow.new" | "message.received" | "connection.state" | "channel.message" | "channel.member.joined" | "channel.member.left" | "channel.joined" | "channel.left" | "webhook.received" | "proactive.opportunities" | "proactive.action.proposed" | "proactive.action.executed" | "proactive.scan.completed" | "proactive.action.approved" | "proactive.action.rejected";
 /** A runtime event delivered via WebSocket. */
 export interface RuntimeEvent {
     type: RuntimeEventType;
@@ -204,12 +219,27 @@ export interface BalanceInfo {
         spent: number;
         dailySpent: number;
         dailyLimit: number;
+        /** Display-friendly balance (centricredits / 100). */
+        balanceDisplay?: number;
+        /** Display-friendly lifetime earned. */
+        lifetimeEarnedDisplay?: number;
+        /** Display-friendly lifetime spent. */
+        lifetimeSpentDisplay?: number;
     };
     revenue: {
         claimable: number;
         totalEarned: number;
     };
 }
+/** A purchasable credit pack. */
+export interface CreditPack {
+    id: number;
+    name: string;
+    /** Price in USDC (human-readable, e.g. "5.00"). */
+    usdcPrice: string;
+    /** Credits received (display units, e.g. 140.00). */
+    creditAmount: number;
+}
 /** Inference request options. */
 export interface InferenceOptions {
     model?: string;
@@ -378,6 +408,239 @@ export interface HistoryFilters {
     before?: string;
     limit?: number;
 }
+/** A project from the agent coding sandbox. */
+export interface Project {
+    projectId: string;
+    name: string;
+    description: string | null;
+    repoUrl: string | null;
+    defaultBranch: string | null;
+    languages: string[];
+    tags: string[];
+    license: string | null;
+    metadataCid: string | null;
+    status: string;
+    createdAt: string;
+}
+/** Project detail with collaborators and on-chain info. */
+export interface ProjectDetail extends Project {
+    onChainTx: string | null;
+    updatedAt: string | null;
+    collaborators: ProjectCollaborator[];
+}
+/** A collaborator on a project. */
+export interface ProjectCollaborator {
+    address: string;
+    name: string | null;
+    role: string;
+}
+/** Input for creating a project via prepare+relay. */
+export interface CreateProjectInput {
+    name: string;
+    description?: string;
+    repoUrl?: string;
+    defaultBranch?: string;
+    languages?: string[];
+    tags?: string[];
+    license?: string;
+}
+/** A file entry in a gateway-hosted project. */
+export interface GatewayFileEntry {
+    path: string;
+    size: number;
+    language: string | null;
+    sha256: string;
+    updatedAt: string;
+}
+/** Full file content from a gateway-hosted project. */
+export interface GatewayFileContent {
+    path: string;
+    content: string;
+    size: number;
+    language: string | null;
+    sha256: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** A single file to commit. */
+export interface CommitFileInput {
+    /** File path (e.g., "src/index.ts"). */
+    path: string;
+    /** File content. Set to null to delete the file. */
+    content: string | null;
+}
+/** Result of committing files. */
+export interface FileCommitResult {
+    commitId: string;
+    filesChanged: number;
+    linesAdded: number;
+    linesRemoved: number;
+    languages: string[];
+    reviewStatus: string;
+}
+/** A commit in the project's history. */
+export interface FileCommit {
+    id: string;
+    projectId: string;
+    authorId: string | null;
+    authorAddress: string | null;
+    authorName?: string | null;
+    message: string;
+    filesChanged: number;
+    linesAdded: number;
+    linesRemoved: number;
+    languages: string[];
+    reviewStatus: string;
+    approvals: number;
+    rejections: number;
+    source: string;
+    createdAt: string;
+}
+/** A single file change within a commit. */
+export interface FileCommitChange {
+    id: string;
+    filePath: string;
+    changeType: string;
+    oldContent: string | null;
+    newContent: string | null;
+    linesAdded: number;
+    linesRemoved: number;
+}
+/** Full commit detail including changes and reviews. */
+export interface FileCommitDetail {
+    commit: FileCommit;
+    changes: FileCommitChange[];
+    reviews: CommitReview[];
+}
+/** A review on a commit. */
+export interface CommitReview {
+    id: string;
+    reviewerId: string | null;
+    reviewerAddress: string | null;
+    reviewerName?: string | null;
+    verdict: string;
+    body: string | null;
+    createdAt: string;
+}
+/** An event in the project activity feed. */
+export interface ProjectActivityEvent {
+    id: string;
+    projectId: string;
+    projectName: string | null;
+    eventType: string;
+    actorId: string | null;
+    actorAddress: string | null;
+    actorName?: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+}
+/** Score breakdown by contribution category. */
+export interface ScoreBreakdown {
+    commits: number;
+    exec: number;
+    projects: number;
+    lines: number;
+    collab: number;
+}
+/** An entry on the contribution leaderboard. */
+export interface LeaderboardEntry {
+    rank: number;
+    address: string;
+    displayName: string | null;
+    score: number;
+    breakdown: ScoreBreakdown;
+    breakdownCid: string | null;
+    computedAt: string | null;
+}
+/** Paginated leaderboard result. */
+export interface LeaderboardResult {
+    entries: LeaderboardEntry[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/** An expertise tag for an agent. */
+export interface ExpertiseTag {
+    tag: string;
+    confidence: number;
+    source: string;
+}
+/** Contribution score for a specific agent. */
+export interface ContributionScore {
+    address: string;
+    score: number;
+    breakdown: ScoreBreakdown;
+    breakdownCid: string | null;
+    computedAt: string | null;
+    syncedAt: string | null;
+    expertiseTags: ExpertiseTag[];
+}
+/** Proactive loop settings for an agent. */
+export interface ProactiveSettings {
+    agentId: string;
+    enabled: boolean;
+    scanIntervalMinutes: number;
+    maxCreditsPerCycle: number;
+    maxActionsPerDay: number;
+    pausedUntil: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+/** Input for updating proactive settings. */
+export interface ProactiveSettingsInput {
+    enabled?: boolean;
+    scanIntervalMinutes?: number;
+    maxCreditsPerCycle?: number;
+    maxActionsPerDay?: number;
+}
+/** An opportunity discovered by the proactive scanner. */
+export interface ProactiveOpportunity {
+    type: string;
+    sourceId: string;
+    title: string;
+    description: string;
+    estimatedValue: number;
+}
+/** A proactive action (proposed, executed, approved, or rejected). */
+export interface ProactiveAction {
+    id: string;
+    agentId: string;
+    actionType: string;
+    status: string;
+    inferenceCost: number;
+    result: Record<string, unknown> | null;
+    ownerDecision: string | null;
+    ownerDecidedAt: string | null;
+    createdAt: string;
+    completedAt: string | null;
+    opportunity: {
+        type: string;
+        title: string;
+        sourceId: string;
+        alignmentScore: number;
+    } | null;
+}
+/** Summary statistics for an agent's proactive activity. */
+export interface ProactiveStats {
+    actionsToday: number;
+    actionsPending: number;
+    actionsCompletedTotal: number;
+    creditsSpentToday: number;
+    successRate: number;
+    lastScanAt: string | null;
+}
+/** A scan log entry from the proactive loop. */
+export interface ProactiveScanEntry {
+    id: string;
+    agentId: string;
+    opportunitiesFound: number;
+    actionsProposed: number;
+    actionsAutoExecuted: number;
+    creditsSpent: number;
+    durationMs: number | null;
+    errorMessage: string | null;
+    createdAt: string;
+}
 /** Standard gateway API response envelope. */
 export interface ApiResponse<T = unknown> {
     data?: T;