@codebolt/narrative 1.11.0

package/dist/types/notifications.d.ts

@@ -0,0 +1,23 @@
+export interface ExecutionStartedEvent {
+    session_id: string;
+    pid: number;
+}
+export interface ExecutionPtyDataEvent {
+    session_id: string;
+    data: string;
+}
+export interface ExecutionExitEvent {
+    session_id: string;
+    exit_code: number | null;
+    signal: number | null;
+}
+export interface ExecutionErrorEvent {
+    session_id: string;
+    error: string;
+}
+export interface NarrativeNotificationMap {
+    'execution.started': ExecutionStartedEvent;
+    'execution.pty_data': ExecutionPtyDataEvent;
+    'execution.exit': ExecutionExitEvent;
+    'execution.error': ExecutionErrorEvent;
+}

package/dist/types/notifications.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/queue.d.ts

@@ -0,0 +1,38 @@
+export interface SlotHolder {
+    execution_id: string;
+    agent_run_id: string;
+    held_for_ms: number;
+}
+export interface MutationSlotInfo {
+    is_held: boolean;
+    is_timed_out: boolean;
+    holder: SlotHolder | null;
+    max_hold_ms: number;
+}
+export interface RunningTask {
+    id: string;
+    task_type: string;
+    command: string;
+    started_at: string | null;
+}
+export interface QueueStatusResult {
+    pending: number;
+    running: number;
+    running_tasks: RunningTask[];
+    mutation_slot: MutationSlotInfo;
+}
+export interface ForceReleaseParams {
+    reason?: string;
+}
+export interface ForceReleaseResult {
+    success: boolean;
+    was_held: boolean;
+    previous_holder: string | null;
+}
+export interface CancelTaskParams {
+    task_id: string;
+}
+export interface CancelTaskResult {
+    success: boolean;
+    task_id: string;
+}

package/dist/types/queue.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/snapshot.d.ts

@@ -0,0 +1,128 @@
+export interface CreateSnapshotParams {
+    agent_run_id: string;
+    thread_id?: string;
+    description?: string;
+    tags?: string[];
+}
+export interface CreateSnapshotResult {
+    snapshot_id: string;
+    tree_hash: string;
+    ref_name: string;
+}
+export interface SnapshotIdParam {
+    snapshot_id: string;
+}
+export interface CreateArchiveResult {
+    archive_path: string;
+    file_count: number;
+}
+export interface ImportArchiveParams {
+    archive_path: string;
+    thread_id: string;
+    remote_snapshot_ref_id?: string;
+    remote_environment_id?: string;
+}
+export interface ImportArchiveResult {
+    snapshot_id: string;
+    tree_hash: string;
+    previous_snapshot_id: string;
+}
+export interface ExportBundleParams {
+    snapshot_id: string;
+    incremental?: boolean;
+    base_snapshot_id?: string;
+}
+export interface ExportBundleResult {
+    bundle_path: string;
+}
+export interface AddBundleParams {
+    bundle_path: string;
+}
+export interface AddBundleResult {
+    imported_refs: [string, string][];
+    snapshot_ids: string[];
+}
+export type BrowseCommand = {
+    type: 'readFile';
+    path: string;
+} | {
+    type: 'listDirectory';
+    path?: string;
+};
+export interface BrowseSnapshotParams {
+    snapshot_id: string;
+    command: BrowseCommand;
+}
+export type BrowseResult = {
+    type: 'fileContent';
+    path: string;
+    content: string;
+} | {
+    type: 'directoryListing';
+    entries: [string, boolean][];
+};
+export type MergeStrategy = {
+    type: 'toCurrentCode';
+    base_snapshot_id: string;
+} | {
+    type: 'withBaseSnapshot';
+    other_snapshot_id: string;
+    base_snapshot_id: string;
+};
+export interface MergeSnapshotParams {
+    snapshot_id: string;
+    strategy: MergeStrategy;
+}
+export interface MergeSnapshotResult {
+    merged_tree_hash: string;
+    is_clean: boolean;
+    conflicts: string[];
+    applied_to_workspace: boolean;
+}
+export interface AddCommitParams {
+    thread_id: string;
+    message: string;
+    snapshot_ids: string[];
+    notes?: string;
+    commit_to_main_repo?: boolean;
+}
+export interface AddCommitResult {
+    commit_hash: string;
+    main_repo_commit_hash: string | null;
+}
+export interface CheckRecoveryParams {
+    snapshot_id: string;
+    thread_id: string;
+}
+export interface RecoveryCheck {
+    recoverable: boolean;
+    recoverable_files: string[];
+    other_thread_changes: string[];
+    total_changes: number;
+}
+export type CheckoutStrategy = {
+    type: 'revert';
+} | {
+    type: 'replace';
+    thread_id: string;
+};
+export interface CheckoutSnapshotParams {
+    snapshot_id: string;
+    strategy: CheckoutStrategy;
+}
+export interface CheckoutResult {
+    restored_tree_hash: string;
+    safety_snapshot_id: string | null;
+}
+export interface DeleteResult {
+    deleted: boolean;
+}
+export interface PruneSnapshotsParams {
+    thread_id?: string;
+    max_age_hours?: number;
+    keep_count?: number;
+}
+export interface PruneResult {
+    pruned_count: number;
+    pruned_ids: string[];
+}

package/dist/types/snapshot.js

@@ -0,0 +1,3 @@
+"use strict";
+// --- createSnapshot ---
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/timeline.d.ts

@@ -0,0 +1,64 @@
+import { NarrativeContext } from './common';
+export interface GetTimelineParams {
+    limit?: number;
+    offset?: number;
+    agent_run_id?: string;
+}
+export interface TimelineSnapshot {
+    id: string;
+    tree_hash: string;
+    created_at: string;
+    agent_run_id: string | null;
+    description: string | null;
+}
+export interface GetTimelineResult {
+    snapshots: TimelineSnapshot[];
+    count: number;
+}
+export interface RestoreSnapshotParams {
+    tree_hash: string;
+    context: NarrativeContext;
+}
+export interface RestoreSnapshotResult {
+    success: boolean;
+    restored_to: string;
+    current_snapshot: string;
+}
+export interface GetSnapshotParams {
+    id?: string;
+    tree_hash?: string;
+}
+export interface GetSnapshotResult {
+    id: string;
+    tree_hash: string;
+    created_at: string;
+    agent_run_id: string | null;
+    description: string | null;
+}
+export interface DiffSnapshotsParams {
+    from_hash?: string;
+    to_hash?: string;
+    from_snapshot?: string;
+    to_snapshot?: string;
+}
+export interface SnapshotDiff {
+    from_hash: string;
+    to_hash: string;
+    added: string[];
+    modified: string[];
+    deleted: string[];
+    diffs: unknown;
+    has_changes: boolean;
+    total_changes: number;
+}
+export interface GetFileAtSnapshotParams {
+    tree_hash: string;
+    file_path: string;
+    encoding?: string;
+}
+export interface GetFileAtSnapshotResult {
+    content: string;
+    encoding: string;
+    file_path: string;
+    tree_hash: string;
+}

package/dist/types/timeline.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/trace.d.ts

@@ -0,0 +1,105 @@
+export interface TraceRecordParam {
+    operation_type: string;
+    details: unknown;
+    file_path?: string;
+    tree_hash_before?: string;
+    tree_hash_after?: string;
+}
+export interface ChangesetFileChange {
+    path: string;
+    content: string;
+    operation: string;
+}
+export interface ChangesetParam {
+    base_tree_hash: string;
+    file_changes: ChangesetFileChange[];
+    deleted_files: string[];
+}
+export interface AnchorParam {
+    tree_hash: string;
+    thread_id: string;
+    environment_id: string;
+}
+export interface CheckpointParam {
+    tree_hash: string;
+    base_anchor_id: string;
+    source_environment_id: string;
+    sequence: number;
+}
+export interface IngestTraceParams {
+    execution_id: string;
+    thread_id: string;
+    environment_id: string;
+    records: TraceRecordParam[];
+    changeset: ChangesetParam;
+    base_anchor: AnchorParam;
+    checkpoint: CheckpointParam;
+    ingested_by?: string;
+}
+export interface IngestTraceResult {
+    ingestion_id: string;
+    execution_trace_id: string;
+    checkpoint_id: string;
+    base_anchor_id: string;
+    source_environment_id: string;
+    files_added: number;
+    files_modified: number;
+    files_deleted: number;
+}
+export interface GetExecutionTraceParams {
+    execution_id: string;
+}
+export interface TraceRecordResult {
+    id: string;
+    operation_type: string;
+    timestamp: string;
+    file_path: string | null;
+    details: unknown;
+}
+export interface ExecutionTraceResult {
+    execution_id: string;
+    thread_id: string;
+    environment_id: string;
+    record_count: number;
+    started_at: string;
+    ended_at: string | null;
+    records: TraceRecordResult[];
+}
+export interface GetThreadTraceParams {
+    thread_id: string;
+}
+export interface TraceSummaryResult {
+    execution_id: string;
+    thread_id: string;
+    environment_id: string;
+    started_at: string;
+    ended_at: string | null;
+    status: string;
+    record_count: number;
+}
+export interface GetFileTraceParams {
+    file_path: string;
+}
+export interface FileChangeResult {
+    record_id: string;
+    execution_id: string;
+    operation_type: string;
+    timestamp: string;
+    tree_hash_before: string | null;
+    tree_hash_after: string | null;
+    details: unknown;
+}
+export interface GetRecentTracesParams {
+    limit?: number;
+}
+export interface IngestionSummaryResult {
+    ingestion_id: string;
+    execution_trace_id: string;
+    checkpoint_id: string;
+    base_anchor_id: string;
+    source_environment_id: string;
+    ingested_at: string;
+    files_added: number;
+    files_modified: number;
+    files_deleted: number;
+}

package/dist/types/trace.js

@@ -0,0 +1,3 @@
+"use strict";
+// --- ingest_remote_execution_trace ---
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@codebolt/narrative",
+  "version": "1.11.0",
+  "description": "TypeScript client for the Codebolt Narrative Engine",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "build:native": "node ../codeboltNarrative/scripts/build-platform-pkg.js",
+    "clean": "rm -rf dist"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "optionalDependencies": {
+    "@codebolt/narrative-darwin-arm64": "1.11.0",
+    "@codebolt/narrative-darwin-x64": "1.11.0",
+    "@codebolt/narrative-linux-x64": "1.11.0",
+    "@codebolt/narrative-linux-arm64": "1.11.0",
+    "@codebolt/narrative-win32-x64": "1.11.0"
+  },
+  "license": "MIT"
+}