@prismer/runtime 1.9.6 → 1.9.21

package/dist/index.d.cts

@@ -208,6 +208,8 @@ declare const HermesProfileConfigSchema: z.ZodObject<{
      */
     hermesSourceDir: z.ZodOptional<z.ZodString>;
     nativeMirrorTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    /** Task authority level: executor (default) or orchestrator. */
+    taskAuthority: z.ZodDefault<z.ZodOptional<z.ZodEnum<["executor", "orchestrator"]>>>;
 }, "strip", z.ZodTypeAny, {
     port: number;
     apiKey: string;
@@ -221,6 +223,7 @@ declare const HermesProfileConfigSchema: z.ZodObject<{
     mirrorNativeKanban: boolean;
     mirrorNativeGoals: boolean;
     nativeMirrorTimeoutMs: number;
+    taskAuthority: "executor" | "orchestrator";
     hermesProfileName?: string | undefined;
     prismerMcpServerPath?: string | undefined;
     prismerProviderBaseUrl?: string | undefined;
@@ -242,6 +245,7 @@ declare const HermesProfileConfigSchema: z.ZodObject<{
     mirrorNativeGoals?: boolean | undefined;
     hermesSourceDir?: string | undefined;
     nativeMirrorTimeoutMs?: number | undefined;
+    taskAuthority?: "executor" | "orchestrator" | undefined;
 }>;
 type HermesProfileConfig = z.infer<typeof HermesProfileConfigSchema>;
 declare const hermesAdapter: AdapterDef;
@@ -306,7 +310,7 @@ type LocalDb = Database.Database;
 declare function openLocalDb(path: string): LocalDb;
 declare function runMigrations(db: LocalDb): void;
 declare function currentSchemaVersion(db: LocalDb): number;
-declare const TARGET_SCHEMA_VERSION = 2;
+declare const TARGET_SCHEMA_VERSION = 3;
 
 type SyncResourceType = 'workspace' | 'agent' | 'agent_profile';
 type SyncOperation = 'create' | 'update' | 'delete';
@@ -1160,6 +1164,69 @@ declare class OutboxWatcher {
     private upload;
 }
 
+interface AssetMetadataRow {
+    assetId: string;
+    contentHash: string;
+    filename: string | null;
+    folderPath: string | null;
+    mime: string;
+    kind: string;
+    sizeBytes: number;
+    description: string | null;
+    assetIndexSeq: number;
+}
+interface AssetMetadataIndexOptions {
+    db: LocalDb;
+    cloud: CloudClient;
+    workspaceId: string;
+    /**
+     * Per-workspace state dir. Caller should pass ~/.prismer/<wid>/ so different
+     * paired workspaces don't race on the cursor file.
+     */
+    workspaceStateDir: string;
+}
+/**
+ * AssetMetadataIndex mirrors cloud-side asset metadata into SQLite for fast
+ * local `#filename` lookup. The cursor file is the only piece of state that
+ * must survive daemon restart; the SQLite mirror is incremental between restarts
+ * (cursor catch-up). Idempotent — safe to retry pullDelta() on errors.
+ */
+declare class AssetMetadataIndex {
+    private readonly db;
+    private readonly cloud;
+    /** Workspace ID — exposed for prismer:// URI construction. */
+    readonly workspaceId: string;
+    private readonly cursorPath;
+    private _lastSyncMs;
+    constructor(opts: AssetMetadataIndexOptions);
+    /** Persisted cursor for this workspace, or 0 on first run / corrupted file. */
+    readCursor(): number;
+    private writeCursor;
+    /**
+     * Pull incremental asset metadata changes since the persisted cursor and
+     * upsert into the local index. Newer rows overwrite older ones by
+     * (workspace_id, asset_id) primary key.
+     *
+     * Returns the count of items applied + the new cursor. Throttled: if called
+     * within 30s of the last successful pull, returns immediately.
+     */
+    pullDelta(opts?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        applied: number;
+        cursor: number;
+    }>;
+    /**
+     * Search local index by filename or description substring.
+     * Escapes LIKE wildcards (% and _). Default limit 8.
+     */
+    search(query: string, limit?: number): AssetMetadataRow[];
+    /** Exact match on filename column. Returns undefined if not indexed. */
+    resolveByFilename(filename: string): AssetMetadataRow | undefined;
+    /** Batch exact match — returns Map for O(1) access. */
+    resolveByFilenames(filenames: string[]): Map<string, AssetMetadataRow>;
+}
+
 interface DispatchDeps {
     registry: AdapterRegistry;
     cloud: CloudClient;
@@ -1183,6 +1250,11 @@ interface DispatchDeps {
     outboxWatcher?: OutboxWatcher;
     /** Daemon paths — used to derive the per-task outbox dir. */
     paths?: ConfigPaths;
+    /**
+     * Multi-workspace asset metadata indexes for #filename resolution.
+     * Keyed by workspaceId. If absent, #ref resolution is skipped entirely.
+     */
+    assetMetadataIndexes?: Map<string, AssetMetadataIndex>;
 }
 declare function handleDispatch(payload: TaskDispatchRequestPayload, requestId: string | undefined, deps: DispatchDeps): Promise<TaskDispatchReplyPayload>;
 /**
@@ -1250,6 +1322,14 @@ interface LocalServerOptions {
      * Sink receives the parsed JSON body and returns a structured result.
      */
     onAssetWrite?: (body: unknown) => Promise<AssetWriteHandlerResult>;
+    /**
+     * Optional handler for `/local/asset/*` routes. Returns true if the request
+     * was handled (response written); false to let the normal route table fall
+     * through. Wired by the daemon runner from `attachAssetRpc()` in
+     * `daemon/asset/rpc.ts` when asset metadata index is enabled.
+     * When set, /healthz reports `assetReady: true`.
+     */
+    attachAsset?: (req: IncomingMessage, res: ServerResponse) => Promise<boolean>;
 }
 interface AssetWriteHandlerResult {
     status: 200 | 400 | 502;
@@ -1334,6 +1414,7 @@ declare class LocalServer {
     start(): Promise<void>;
     stop(): Promise<void>;
     private route;
+    private runHandlers;
     private routeStandard;
     /**
      * POST /v1/agents/install — cloud/controller installs one hosted agent on
@@ -1405,6 +1486,7 @@ declare class Runner extends EventEmitter {
     private localServer?;
     private outboxWatcher?;
     private memoryWiring?;
+    private assetMetadataIndexes;
     private state;
     private startedAt;
     private workspaceId;
@@ -1458,8 +1540,15 @@ declare class Runner extends EventEmitter {
     private syncProfileFromCloud;
     private resolveOwnedAgent;
     private onWorkspaceChanged;
+    private onAssetChanged;
     private onWorkspaceFileChanged;
     private snapshotAdapterObservability;
+    /**
+     * Ensure an AssetMetadataIndex exists for the given workspace and pull
+     * delta from cloud. Idempotent — creates the index on first call, reuses
+     * it on subsequent calls. Same cursor-catch-up semantics as WorkspaceMirror.
+     */
+    private syncAssetMetadata;
     /**
      * SyncWorker FlushFn — pushes local writes to cloud.
      *

package/dist/index.d.ts

@@ -208,6 +208,8 @@ declare const HermesProfileConfigSchema: z.ZodObject<{
      */
     hermesSourceDir: z.ZodOptional<z.ZodString>;
     nativeMirrorTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    /** Task authority level: executor (default) or orchestrator. */
+    taskAuthority: z.ZodDefault<z.ZodOptional<z.ZodEnum<["executor", "orchestrator"]>>>;
 }, "strip", z.ZodTypeAny, {
     port: number;
     apiKey: string;
@@ -221,6 +223,7 @@ declare const HermesProfileConfigSchema: z.ZodObject<{
     mirrorNativeKanban: boolean;
     mirrorNativeGoals: boolean;
     nativeMirrorTimeoutMs: number;
+    taskAuthority: "executor" | "orchestrator";
     hermesProfileName?: string | undefined;
     prismerMcpServerPath?: string | undefined;
     prismerProviderBaseUrl?: string | undefined;
@@ -242,6 +245,7 @@ declare const HermesProfileConfigSchema: z.ZodObject<{
     mirrorNativeGoals?: boolean | undefined;
     hermesSourceDir?: string | undefined;
     nativeMirrorTimeoutMs?: number | undefined;
+    taskAuthority?: "executor" | "orchestrator" | undefined;
 }>;
 type HermesProfileConfig = z.infer<typeof HermesProfileConfigSchema>;
 declare const hermesAdapter: AdapterDef;
@@ -306,7 +310,7 @@ type LocalDb = Database.Database;
 declare function openLocalDb(path: string): LocalDb;
 declare function runMigrations(db: LocalDb): void;
 declare function currentSchemaVersion(db: LocalDb): number;
-declare const TARGET_SCHEMA_VERSION = 2;
+declare const TARGET_SCHEMA_VERSION = 3;
 
 type SyncResourceType = 'workspace' | 'agent' | 'agent_profile';
 type SyncOperation = 'create' | 'update' | 'delete';
@@ -1160,6 +1164,69 @@ declare class OutboxWatcher {
     private upload;
 }
 
+interface AssetMetadataRow {
+    assetId: string;
+    contentHash: string;
+    filename: string | null;
+    folderPath: string | null;
+    mime: string;
+    kind: string;
+    sizeBytes: number;
+    description: string | null;
+    assetIndexSeq: number;
+}
+interface AssetMetadataIndexOptions {
+    db: LocalDb;
+    cloud: CloudClient;
+    workspaceId: string;
+    /**
+     * Per-workspace state dir. Caller should pass ~/.prismer/<wid>/ so different
+     * paired workspaces don't race on the cursor file.
+     */
+    workspaceStateDir: string;
+}
+/**
+ * AssetMetadataIndex mirrors cloud-side asset metadata into SQLite for fast
+ * local `#filename` lookup. The cursor file is the only piece of state that
+ * must survive daemon restart; the SQLite mirror is incremental between restarts
+ * (cursor catch-up). Idempotent — safe to retry pullDelta() on errors.
+ */
+declare class AssetMetadataIndex {
+    private readonly db;
+    private readonly cloud;
+    /** Workspace ID — exposed for prismer:// URI construction. */
+    readonly workspaceId: string;
+    private readonly cursorPath;
+    private _lastSyncMs;
+    constructor(opts: AssetMetadataIndexOptions);
+    /** Persisted cursor for this workspace, or 0 on first run / corrupted file. */
+    readCursor(): number;
+    private writeCursor;
+    /**
+     * Pull incremental asset metadata changes since the persisted cursor and
+     * upsert into the local index. Newer rows overwrite older ones by
+     * (workspace_id, asset_id) primary key.
+     *
+     * Returns the count of items applied + the new cursor. Throttled: if called
+     * within 30s of the last successful pull, returns immediately.
+     */
+    pullDelta(opts?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        applied: number;
+        cursor: number;
+    }>;
+    /**
+     * Search local index by filename or description substring.
+     * Escapes LIKE wildcards (% and _). Default limit 8.
+     */
+    search(query: string, limit?: number): AssetMetadataRow[];
+    /** Exact match on filename column. Returns undefined if not indexed. */
+    resolveByFilename(filename: string): AssetMetadataRow | undefined;
+    /** Batch exact match — returns Map for O(1) access. */
+    resolveByFilenames(filenames: string[]): Map<string, AssetMetadataRow>;
+}
+
 interface DispatchDeps {
     registry: AdapterRegistry;
     cloud: CloudClient;
@@ -1183,6 +1250,11 @@ interface DispatchDeps {
     outboxWatcher?: OutboxWatcher;
     /** Daemon paths — used to derive the per-task outbox dir. */
     paths?: ConfigPaths;
+    /**
+     * Multi-workspace asset metadata indexes for #filename resolution.
+     * Keyed by workspaceId. If absent, #ref resolution is skipped entirely.
+     */
+    assetMetadataIndexes?: Map<string, AssetMetadataIndex>;
 }
 declare function handleDispatch(payload: TaskDispatchRequestPayload, requestId: string | undefined, deps: DispatchDeps): Promise<TaskDispatchReplyPayload>;
 /**
@@ -1250,6 +1322,14 @@ interface LocalServerOptions {
      * Sink receives the parsed JSON body and returns a structured result.
      */
     onAssetWrite?: (body: unknown) => Promise<AssetWriteHandlerResult>;
+    /**
+     * Optional handler for `/local/asset/*` routes. Returns true if the request
+     * was handled (response written); false to let the normal route table fall
+     * through. Wired by the daemon runner from `attachAssetRpc()` in
+     * `daemon/asset/rpc.ts` when asset metadata index is enabled.
+     * When set, /healthz reports `assetReady: true`.
+     */
+    attachAsset?: (req: IncomingMessage, res: ServerResponse) => Promise<boolean>;
 }
 interface AssetWriteHandlerResult {
     status: 200 | 400 | 502;
@@ -1334,6 +1414,7 @@ declare class LocalServer {
     start(): Promise<void>;
     stop(): Promise<void>;
     private route;
+    private runHandlers;
     private routeStandard;
     /**
      * POST /v1/agents/install — cloud/controller installs one hosted agent on
@@ -1405,6 +1486,7 @@ declare class Runner extends EventEmitter {
     private localServer?;
     private outboxWatcher?;
     private memoryWiring?;
+    private assetMetadataIndexes;
     private state;
     private startedAt;
     private workspaceId;
@@ -1458,8 +1540,15 @@ declare class Runner extends EventEmitter {
     private syncProfileFromCloud;
     private resolveOwnedAgent;
     private onWorkspaceChanged;
+    private onAssetChanged;
     private onWorkspaceFileChanged;
     private snapshotAdapterObservability;
+    /**
+     * Ensure an AssetMetadataIndex exists for the given workspace and pull
+     * delta from cloud. Idempotent — creates the index on first call, reuses
+     * it on subsequent calls. Same cursor-catch-up semantics as WorkspaceMirror.
+     */
+    private syncAssetMetadata;
     /**
      * SyncWorker FlushFn — pushes local writes to cloud.
      *