@harperfast/harper 5.0.30 → 5.1.0-beta.2

package/dataLayer/{schema.js → schema.ts}

@@ -1,22 +1,23 @@
 'use strict';
 
-const schemaMetadataValidator = require('../validation/schemaMetadataValidator.js');
-const { validateBySchema } = require('../validation/validationWrapper.js');
-const { commonValidators, schemaRegex } = require('../validation/common_validators.js');
-const Joi = require('joi');
-const logger = require('../utility/logging/harper_logger.js');
-const uuidV4 = require('uuid').v4;
-const signalling = require('../utility/signalling.js');
-const hdbTerms = require('../utility/hdbTerms.ts');
-const util = require('util');
-const harperBridge = require('./harperBridge/harperBridge.js');
-const { handleHDBError, hdbErrors, ClientError } = require('../utility/errors/hdbError.js');
-const { HDB_ERROR_MSGS, HTTP_STATUS_CODES } = hdbErrors;
-const { SchemaEventMsg } = require('../server/threads/itc.js');
-const { getDatabases, dropTableMeta } = require('../resources/databases.ts');
-const { transformReq } = require('../utility/common_utils.js');
-const { server } = require('../server/Server.ts');
-const { cleanupOrphans } = require('../resources/blob.ts');
+import * as schemaMetadataValidator from '../validation/schemaMetadataValidator.ts';
+import { validateBySchema } from '../validation/validationWrapper.ts';
+import { commonValidators, schemaRegex } from '../validation/common_validators.ts';
+import Joi from 'joi';
+import logger from '../utility/logging/harper_logger.ts';
+import { v4 as uuidV4 } from 'uuid';
+import * as signalling from '../utility/signalling.ts';
+import * as hdbTerms from '../utility/hdbTerms.ts';
+import * as util from 'util';
+const harperBridge = require('./harperBridge/harperBridge').default;
+import { handleHDBError, ClientError } from '../utility/errors/hdbError.ts';
+import { HDB_ERROR_MSGS, HTTP_STATUS_CODES } from '../utility/errors/commonErrors.ts';
+
+import { SchemaEventMsg } from '../server/threads/itc.js';
+import { getDatabases, dropTableMeta } from '../resources/databases.ts';
+import { transformReq } from '../utility/common_utils.ts';
+import { server } from '../server/Server.ts';
+import { cleanupOrphans } from '../resources/blob.ts';
 
 const DB_NAME_CONSTRAINTS = Joi.string()
 	.min(1)
@@ -42,22 +43,9 @@ const PRIMARY_KEY_CONSTRAINTS = Joi.string()
 	})
 	.required();
 
-module.exports = {
-	createSchema,
-	createSchemaStructure,
-	createTable,
-	createTableStructure,
-	createAttribute,
-	dropSchema,
-	dropTable,
-	dropAttribute,
-	getBackup,
-	cleanupOrphanBlobs,
-};
-
 /** EXPORTED FUNCTIONS **/
 
-async function createSchema(schemaCreateObject) {
+export async function createSchema(schemaCreateObject: any) {
 	let schemaStructure = await createSchemaStructure(schemaCreateObject);
 	signalling.signalSchemaChange(
 		new SchemaEventMsg(process.pid, schemaCreateObject.operation, schemaCreateObject.schema)
@@ -66,7 +54,7 @@ async function createSchema(schemaCreateObject) {
 	return schemaStructure;
 }
 
-async function createSchemaStructure(schemaCreateObject) {
+export async function createSchemaStructure(schemaCreateObject: any) {
 	const validation = validateBySchema(
 		schemaCreateObject,
 		Joi.object({
@@ -94,13 +82,13 @@ async function createSchemaStructure(schemaCreateObject) {
 	return `database '${schemaCreateObject.schema}' successfully created`;
 }
 
-async function createTable(createTableObject) {
+export async function createTable(createTableObject: any) {
 	transformReq(createTableObject);
 	createTableObject.primary_key = createTableObject.primary_key ?? createTableObject.hash_attribute;
 	return await createTableStructure(createTableObject);
 }
 
-async function createTableStructure(createTableObject) {
+export async function createTableStructure(createTableObject: any) {
 	const validation = validateBySchema(
 		createTableObject,
 		Joi.object({
@@ -128,7 +116,7 @@ async function createTableStructure(createTableObject) {
 		);
 	}
 
-	let tableSystemData = {
+	let tableSystemData: any = {
 		name: createTableObject.table,
 		schema: createTableObject.schema,
 		id: uuidV4(),
@@ -153,7 +141,7 @@ async function createTableStructure(createTableObject) {
 	return `table '${createTableObject.schema}.${createTableObject.table}' successfully created.`;
 }
 
-async function dropSchema(dropSchemaObject) {
+export async function dropSchema(dropSchemaObject: any) {
 	const validation = validateBySchema(
 		dropSchemaObject,
 		Joi.object({
@@ -189,7 +177,7 @@ async function dropSchema(dropSchemaObject) {
 	return response;
 }
 
-async function dropTable(dropTableObject) {
+export async function dropTable(dropTableObject: any) {
 	const validation = validateBySchema(
 		dropTableObject,
 		Joi.object({
@@ -231,7 +219,7 @@ async function dropTable(dropTableObject) {
  * @param dropAttributeObject - The JSON formatted inbound message.
  * @returns {Promise<*>}
  */
-async function dropAttribute(dropAttributeObject) {
+export async function dropAttribute(dropAttributeObject: any) {
 	const validation = validateBySchema(
 		dropAttributeObject,
 		Joi.object({
@@ -315,13 +303,13 @@ function dropAttributeFromGlobal(dropAttributeObject) {
 	);
 
 	for (let i = 0; i < attributesObj.length; i++) {
-		if (attributesObj[i].attribute === dropAttributeObject.attribute) {
+		if ((attributesObj[i] as any).attribute === dropAttributeObject.attribute) {
 			global.hdb_schema[dropAttributeObject.schema][dropAttributeObject.table]['attributes'].splice(i, 1);
 		}
 	}
 }
 
-async function createAttribute(createAttributeObject) {
+export async function createAttribute(createAttributeObject: any) {
 	transformReq(createAttributeObject);
 
 	const tableAttr = getDatabases()[createAttributeObject.schema][createAttributeObject.table].attributes;
@@ -352,15 +340,15 @@ async function createAttribute(createAttributeObject) {
 	return `attribute '${createAttributeObject.schema}.${createAttributeObject.table}.${createAttributeObject.attribute}' successfully created.`;
 }
 
-function getBackup(getBackupObject) {
+export function getBackup(getBackupObject: any) {
 	return harperBridge.getBackup(getBackupObject);
 }
 
-function cleanupOrphanBlobs(request) {
+export function cleanupOrphanBlobs(request: any) {
 	if (!request.database) throw new ClientError('Must provide "database" name for search for orphaned blobs');
-	const database = databases[request.database];
+	const database: any = (databases as any)[request.database];
 	if (!database) throw new ClientError(`Unknown database '${request.database}'`);
 	// don't await, it will probably take hours
-	cleanupOrphans(databases[request.database], request.database);
+	cleanupOrphans((databases as any)[request.database], request.database);
 	return { message: 'Orphaned blobs cleanup started, check logs for progress' };
 }

package/dataLayer/{schemaDescribe.js → schemaDescribe.ts}

@@ -1,22 +1,17 @@
-'use strict';
+import { RocksDatabase } from '@harperfast/rocksdb-js';
+('use strict');
 
-const logger = require('../utility/logging/harper_logger.js');
-const { validateBySchema } = require('../validation/validationWrapper.js');
-const Joi = require('joi');
-const hdbUtils = require('../utility/common_utils.js');
-const { handleHDBError, hdbErrors, ClientError } = require('../utility/errors/hdbError.js');
-const { HDB_ERROR_MSGS, HTTP_STATUS_CODES } = hdbErrors;
-const envMngr = require('../utility/environment/environmentManager.js');
-envMngr.initSync();
-const { getDatabases } = require('../resources/databases.ts');
-const fs = require('fs-extra');
-const { RocksDatabase } = require('@harperfast/rocksdb-js');
+import logger from '../utility/logging/harper_logger.ts';
+import { validateBySchema } from '../validation/validationWrapper.ts';
+import Joi from 'joi';
+import * as hdbUtils from '../utility/common_utils.ts';
+import { handleHDBError, ClientError } from '../utility/errors/hdbError.ts';
+import { HDB_ERROR_MSGS, HTTP_STATUS_CODES } from '../utility/errors/commonErrors.ts';
 
-module.exports = {
-	describeAll,
-	describeTable: descTable,
-	describeSchema,
-};
+import * as envMngr from '../utility/environment/environmentManager.ts';
+envMngr.initSync();
+import { getDatabases } from '../resources/databases.ts';
+import * as fs from 'fs-extra';
 
 /**
  * This method is exposed to the API and internally for system operations.  If the op is being made internally, the `opObj`
@@ -24,7 +19,7 @@ module.exports = {
  * @param opObj
  * @returns {Promise<{}|HdbError>}
  */
-async function describeAll(opObj = {}) {
+export async function describeAll(opObj: any = {}) {
 	try {
 		const sysCall = hdbUtils.isEmptyOrZeroLength(opObj);
 		const bypassAuth = !!opObj.bypass_auth;
@@ -110,7 +105,7 @@ async function describeAll(opObj = {}) {
  * includes the users role and permissions.
  * @returns {Promise<{}|*>}
  */
-async function descTable(describeTableObject, attrPerms) {
+async function descTable(describeTableObject: any, attrPerms?: any) {
 	hdbUtils.transformReq(describeTableObject);
 	let { schema, table } = describeTableObject;
 	schema = schema?.toString();
@@ -163,6 +158,7 @@ async function descTable(describeTableObject, attrPerms) {
 				assigned_updated_time: att.assignUpdatedTime,
 				nullable: att.nullable,
 				computed: att.computed ? true : undefined, // only include if computed
+				embed: att.embed ? { source: att.embed.source, model: att.embed.model } : undefined,
 				properties: att.properties
 					? att.properties.map((prop) => {
 							return { type: prop.type, name: prop.name };
@@ -194,7 +190,7 @@ async function descTable(describeTableObject, attrPerms) {
 	} catch (error) {
 		logger.warn(`unable to get database size`, error);
 	}
-	let tableResult = {
+	let tableResult: any = {
 		schema,
 		name: tableObj.tableName,
 		primary_key: tableObj.attributes.find((attribute) => attribute.isPrimaryKey || attribute.isPrimaryKey)?.name,
@@ -206,10 +202,10 @@ async function descTable(describeTableObject, attrPerms) {
 	if (tableObj.replicate !== undefined) tableResult.replicate = tableObj.replicate;
 	if (tableObj.expirationMS !== undefined) tableResult.expiration = tableObj.expirationMS / 1000 + 's';
 	if (tableObj.sealed !== undefined) tableResult.sealed = tableObj.sealed;
-	if (tableObj.sources?.length > 0)
-		tableResult.sources = tableObj.sources
-			.map((source) => source.name)
-			.filter((source) => source && source !== 'Replicator');
+	if ((tableObj as any).sources?.length > 0)
+		tableResult.sources = (tableObj as any).sources
+			.map((source: any) => source.name)
+			.filter((source: any) => source && source !== 'Replicator');
 
 	try {
 		const recordCount = await tableObj.getRecordCount({ exactCount: !!describeTableObject.exact_count });
@@ -238,9 +234,9 @@ async function descTable(describeTableObject, attrPerms) {
  * Returns the schema metadata filtered based on permissions for the user role making the request
  *
  * @param describeSchemaObject
- * @returns {Promise<{}|[]>}
+ * @returns {Promise<Record<string, any>>}
  */
-async function describeSchema(describeSchemaObject) {
+export async function describeSchema(describeSchemaObject: any) {
 	hdbUtils.transformReq(describeSchemaObject);
 
 	const validation = validateBySchema(
@@ -292,3 +288,4 @@ async function describeSchema(describeSchemaObject) {
 	}
 	return results;
 }
+export { descTable as describeTable };

package/dataLayer/{search.js → search.ts}

@@ -1,21 +1,14 @@
 'use strict';
 
-module.exports = {
-	searchByConditions,
-	searchByHash,
-	searchByValue,
-	search,
-};
+const harperBridge = require('./harperBridge/harperBridge').default;
+import { transformReq } from '../utility/common_utils.ts';
 
-const harperBridge = require('./harperBridge/harperBridge.js');
-const { transformReq } = require('../utility/common_utils.js');
-
-async function searchByConditions(searchObject) {
+export async function searchByConditions(searchObject: any) {
 	transformReq(searchObject);
 	return harperBridge.searchByConditions(searchObject);
 }
 
-async function searchByHash(searchObject) {
+export async function searchByHash(searchObject: any) {
 	transformReq(searchObject);
 	if (searchObject.ids) searchObject.hash_values = searchObject.ids;
 	let array = [];
@@ -25,7 +18,7 @@ async function searchByHash(searchObject) {
 	return array;
 }
 
-async function searchByValue(searchObject) {
+export async function searchByValue(searchObject: any) {
 	transformReq(searchObject);
 	if (searchObject.hasOwnProperty('desc') === true) {
 		searchObject.reverse = searchObject.desc;
@@ -37,10 +30,11 @@ async function searchByValue(searchObject) {
 	return array;
 }
 
-function search(statement, callback) {
+export function search(statement: any, callback: any) {
 	try {
-		const SelectValidator = require('../sqlTranslator/SelectValidator.js');
-		const SQLSearch = require('./SQLSearch.js');
+		const SelectValidator =
+			require('../sqlTranslator/SelectValidator').default || require('../sqlTranslator/SelectValidator');
+		const SQLSearch = require('./SQLSearch').default || require('./SQLSearch');
 		let validator = new SelectValidator(statement);
 		validator.validate();
 

package/dataLayer/{transaction.js → transaction.ts}

@@ -1,10 +1,7 @@
 'use strict';
 
-const harperBridge = require('./harperBridge/harperBridge.js');
+const harperBridge = require('./harperBridge/harperBridge').default;
 
-module.exports = {
-	writeTransaction,
-};
 /**
  * This is wrapper for write transactions, ensuring that all reads and writes within the callback occur atomically
  * @param schema
@@ -12,6 +9,6 @@ module.exports = {
  * @param callback
  * @returns {Promise<any>}
  */
-function writeTransaction(schema, table, callback) {
+export function writeTransaction(schema: string, table: string, callback: any) {
 	return harperBridge.writeTransaction(schema, table, callback);
 }

package/dataLayer/{update.js → update.ts}

@@ -1,27 +1,23 @@
 'use strict';
 
-const search = require('./search.js');
-const globalSchema = require('../utility/globalSchema.js');
-const logger = require('../utility/logging/harper_logger.js');
-const write = require('./insert.js');
-const clone = require('clone');
-const alasql = require('alasql');
-const alasqlFunctionImporter = require('../sqlTranslator/alasqlFunctionImporter.js');
-const util = require('util');
+import * as search from './search.ts';
+import * as globalSchema from '../utility/globalSchema.ts';
+import logger from '../utility/logging/harper_logger.ts';
+import * as write from './insert.ts';
+import clone from 'clone';
+import * as alasql from 'alasql';
+import alasqlFunctionImporter from '../sqlTranslator/alasqlFunctionImporter.ts';
+import * as util from 'util';
 
 const pGetTableSchema = util.promisify(globalSchema.getTableSchema);
 const pSearch = util.promisify(search.search);
 
-const terms = require('../utility/hdbTerms.ts');
-const hdbUtils = require('../utility/common_utils.js');
+import * as terms from '../utility/hdbTerms.ts';
+import * as hdbUtils from '../utility/common_utils.ts';
 
 //here we call to define and import custom functions to alasql
 alasqlFunctionImporter(alasql);
 
-module.exports = {
-	update,
-};
-
 const SQL_UPDATE_ERROR_MSG = 'There was a problem performing this update. Please check the logs and try again.';
 
 /**
@@ -31,8 +27,8 @@ const SQL_UPDATE_ERROR_MSG = 'There was a problem performing this update. Please
  * @param hdb_user
  * @return
  */
-async function update({ statement, hdb_user }) {
-	let tableInfo = await pGetTableSchema(statement.table.databaseid, statement.table.tableid);
+async function updateData({ statement, hdb_user }: any) {
+	let tableInfo: any = await pGetTableSchema(statement.table.databaseid, statement.table.tableid);
 	let update_record = createUpdateRecord(statement.columns);
 
 	//convert this update statement to a SQL search capable statement
@@ -43,9 +39,9 @@ async function update({ statement, hdb_user }) {
 	let whereString = hdbUtils.isEmpty(where) ? '' : ` WHERE ${where.toString()}`;
 
 	let selectString = `SELECT ${tableInfo.hash_attribute} FROM ${from.toString()} ${whereString}`;
-	let searchStatement = alasql.parse(selectString).statements[0];
+	let searchStatement = (alasql as any).parse(selectString).statements[0];
 	//let result = await transaction.writeTransaction(tableInfo.schema, tableInfo.name, async () => {
-	let records = await pSearch(searchStatement);
+	let records: any = await pSearch(searchStatement);
 	let newRecords = buildUpdateRecords(update_record, records);
 	return updateRecords(tableClone, newRecords, hdb_user);
 	//});
@@ -57,7 +53,7 @@ async function update({ statement, hdb_user }) {
  * creates a json object based on the AST
  * @param columns
  */
-function createUpdateRecord(columns) {
+function createUpdateRecord(columns: any[]) {
 	try {
 		let record = {};
 
@@ -65,7 +61,7 @@ function createUpdateRecord(columns) {
 			if ('value' in column.expression) {
 				record[column.column.columnid] = column.expression.value ?? null;
 			} else {
-				record[column.column.columnid] = alasql.compile(
+				record[column.column.columnid] = (alasql as any).compile(
 					`SELECT ${column.expression.toString()} AS [${terms.FUNC_VAL}] FROM ?`
 				);
 			}
@@ -85,7 +81,7 @@ function createUpdateRecord(columns) {
  * @param {[]} records
  * @return
  */
-function buildUpdateRecords(update_record, records) {
+function buildUpdateRecords(update_record: any, records: any[]) {
 	if (hdbUtils.isEmptyOrZeroLength(records)) {
 		return [];
 	}
@@ -101,7 +97,7 @@ function buildUpdateRecords(update_record, records) {
  * @param {{}} hdb_user
  * @return
  */
-async function updateRecords(table, records, hdb_user) {
+async function updateRecords(table: any, records: any[], hdb_user: any) {
 	let updateObject = {
 		operation: 'update',
 		schema: table.databaseid_orig,
@@ -122,3 +118,4 @@ async function updateRecords(table, records, hdb_user) {
 
 	return res;
 }
+export { updateData as update };

package/dist/agent/agent.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Built-in Harper Agent component (#626).
+ *
+ * `startOnMainThread` is invoked once on the main thread by `componentLoader`.
+ * When `agent.enabled` is `false` (default) the component registers nothing
+ * and returns immediately — opt-in keeps surprise LLM costs at bay. When
+ * enabled, the six operations land on the operations API, the session table
+ * is realized lazily on first use, and the loop runs in-process.
+ *
+ * The component intentionally avoids `handleApplication`: it has nothing
+ * worker-thread-shaped to do. Operator-only tools (FS, schedule, fetch) are
+ * inline; registry-backed tools (#615/#617/#618) will fold in via toolset.ts
+ * once those land.
+ */
+interface StartOpts {
+    server: {
+        registerOperation: (def: {
+            name: string;
+            execute: (op: any) => any | Promise<any>;
+        }) => void;
+    };
+    enabled?: boolean;
+    provider?: string;
+    model?: string;
+    maxTurns?: number;
+    maxCostUsd?: number;
+    autoApprove?: boolean;
+    allowDestructive?: boolean;
+    user?: string;
+    componentsScope?: string;
+}
+export declare function startOnMainThread(opts: StartOpts): Promise<void>;
+/** Test-only: reset module state between specs. */
+export declare function _resetForTests(): void;
+export {};

package/dist/agent/agent.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * Built-in Harper Agent component (#626).
+ *
+ * `startOnMainThread` is invoked once on the main thread by `componentLoader`.
+ * When `agent.enabled` is `false` (default) the component registers nothing
+ * and returns immediately — opt-in keeps surprise LLM costs at bay. When
+ * enabled, the six operations land on the operations API, the session table
+ * is realized lazily on first use, and the loop runs in-process.
+ *
+ * The component intentionally avoids `handleApplication`: it has nothing
+ * worker-thread-shaped to do. Operator-only tools (FS, schedule, fetch) are
+ * inline; registry-backed tools (#615/#617/#618) will fold in via toolset.ts
+ * once those land.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startOnMainThread = startOnMainThread;
+exports._resetForTests = _resetForTests;
+const node_path_1 = require("node:path");
+const hdbTerms_ts_1 = require("../utility/hdbTerms.js");
+const harper_logger_ts_1 = __importDefault(require("../utility/logging/harper_logger.js"));
+const Models_ts_1 = require("../resources/models/Models.js");
+const toolset_ts_1 = require("./toolset.js");
+const operations_ts_1 = require("./operations.js");
+const loop_ts_1 = require("./loop.js");
+const session_ts_1 = require("./session.js");
+const log = harper_logger_ts_1.default.loggerWithTag('agent');
+const DEFAULT_CONFIG = {
+    enabled: false,
+    maxTurns: 50,
+    maxCostUsd: 5,
+    autoApprove: false,
+    allowDestructive: false,
+    user: 'hdb_agent',
+};
+async function startOnMainThread(opts) {
+    const config = mergeConfig(opts);
+    if (!config.enabled) {
+        log.info?.('Agent component disabled (agent.enabled=false); skipping registration');
+        return;
+    }
+    // Lazily required to avoid pulling configUtils at module-eval time for tests.
+    const { getConfigPath, getConfigFilePath } = require('../config/configUtils.js');
+    const scopes = resolveScopes(config, getConfigPath, getConfigFilePath);
+    const models = new Models_ts_1.Models();
+    const abortControllers = new Map();
+    let liveConfig = config;
+    let composed = (0, toolset_ts_1.composeToolset)({
+        allowDestructive: liveConfig.allowDestructive,
+        onFollowup: handleFollowup,
+    });
+    // Only warn when the operator explicitly configured `maxCostUsd`. Logging on the default
+    // every boot would flood the log without telling anyone anything actionable.
+    if (opts.maxCostUsd !== undefined) {
+        log.warn?.(`agent.maxCostUsd=${liveConfig.maxCostUsd} is advertised but not yet enforced; cost-cap wiring depends on #612 telemetry.`);
+    }
+    async function handleFollowup(sessionId, prompt) {
+        const session = await (0, session_ts_1.getSession)(sessionId);
+        if (!session) {
+            log.warn?.(`schedule_followup target session ${sessionId} not found`);
+            return;
+        }
+        await (0, session_ts_1.appendMessage)(sessionId, { role: 'user', content: prompt, createdAt: Date.now() });
+        startRun(sessionId);
+    }
+    function currentTools() {
+        return composed.tools;
+    }
+    function startRun(sessionId) {
+        // A run is already active for this session. `runAgent` coalesces concurrent starts onto the
+        // existing in-flight promise (bound to the existing controller), so creating a second
+        // controller here would orphan it — `cancelRun` would then abort a controller nothing is
+        // listening to, leaving the live run uncancellable. Any message appended before this call
+        // (e.g. by a scheduled followup) is picked up by the in-flight loop on its next turn.
+        if (abortControllers.has(sessionId))
+            return;
+        const controller = new AbortController();
+        abortControllers.set(sessionId, controller);
+        (0, loop_ts_1.runAgent)({
+            sessionId,
+            models,
+            tools: currentTools(),
+            scopes,
+            maxTurns: liveConfig.maxTurns,
+            autoApprove: liveConfig.autoApprove,
+            signal: controller.signal,
+            generateOpts: { model: liveConfig.model },
+        })
+            .catch((err) => log.error?.(`Agent run failed for ${sessionId}: ${err?.message ?? err}`))
+            .finally(() => {
+            if (abortControllers.get(sessionId) === controller)
+                abortControllers.delete(sessionId);
+        });
+    }
+    function cancelRun(sessionId) {
+        // Clear any scheduled followups first. Without this, a timer set via `schedule_followup`
+        // would fire after the operator cancelled, silently re-injecting a user prompt and kicking
+        // the loop off again — surprising behavior and avoidable LLM cost.
+        for (const [id, followup] of composed.scheduled.entries()) {
+            if (followup.sessionId === sessionId) {
+                clearTimeout(followup.timer);
+                composed.scheduled.delete(id);
+            }
+        }
+        const controller = abortControllers.get(sessionId);
+        if (!controller)
+            return false;
+        controller.abort(new Error('cancelled by operator'));
+        abortControllers.delete(sessionId);
+        return true;
+    }
+    function setConfig(patch) {
+        const previousAllowDestructive = liveConfig.allowDestructive;
+        liveConfig = { ...liveConfig, ...patch };
+        if (liveConfig.allowDestructive !== previousAllowDestructive) {
+            composed = (0, toolset_ts_1.composeToolset)({
+                allowDestructive: liveConfig.allowDestructive,
+                onFollowup: handleFollowup,
+            });
+        }
+        // NOTE: an already in-flight run captured its toolset (and autoApprove) at start, so flipping
+        // allowDestructive here only affects subsequent runs — the live loop finishes on its existing
+        // toolset. Acceptable: the approval gate still applies on the next turn's run, and operators
+        // who need to halt a run immediately use cancel_agent_run. Tightening to per-turn re-evaluation
+        // would require threading a config getter into the loop; deferred until there's a need.
+        return liveConfig;
+    }
+    const operations = (0, operations_ts_1.buildOperations)({
+        getConfig: () => liveConfig,
+        setConfig,
+        startRun,
+        cancelRun,
+    });
+    for (const op of operations)
+        opts.server.registerOperation(op);
+    log.info?.(`Agent component initialized with ${composed.tools.length} tools`);
+}
+function resolveScopes(config, getConfigPath, getConfigFilePath) {
+    const componentsRoot = getConfigPath(hdbTerms_ts_1.CONFIG_PARAMS.COMPONENTSROOT) ?? process.cwd();
+    const logDir = getConfigPath(hdbTerms_ts_1.CONFIG_PARAMS.LOGGING_ROOT) ?? process.cwd();
+    const rootPath = getConfigPath(hdbTerms_ts_1.CONFIG_PARAMS.ROOTPATH) ?? componentsRoot;
+    const configFile = getConfigFilePath?.();
+    const configDir = configFile ? (0, node_path_1.dirname)(configFile) : process.cwd();
+    // A relative `componentsScope` is resolved against rootPath, as documented in the schema —
+    // NOT against componentsRoot, which would double-nest (`./components` → componentsRoot/components).
+    // With no scope set, the full componentsRoot is the FS write scope.
+    const scopedComponents = config.componentsScope
+        ? (0, node_path_1.isAbsolute)(config.componentsScope)
+            ? config.componentsScope
+            : (0, node_path_1.resolve)(rootPath, config.componentsScope)
+        : componentsRoot;
+    return { componentsRoot: scopedComponents, logDir, configDir };
+}
+function mergeConfig(opts) {
+    return {
+        ...DEFAULT_CONFIG,
+        ...(opts.enabled !== undefined && { enabled: !!opts.enabled }),
+        ...(opts.provider !== undefined && { provider: String(opts.provider) }),
+        ...(opts.model !== undefined && { model: String(opts.model) }),
+        ...(opts.maxTurns !== undefined && { maxTurns: Number(opts.maxTurns) }),
+        ...(opts.maxCostUsd !== undefined && { maxCostUsd: Number(opts.maxCostUsd) }),
+        ...(opts.autoApprove !== undefined && { autoApprove: !!opts.autoApprove }),
+        ...(opts.allowDestructive !== undefined && { allowDestructive: !!opts.allowDestructive }),
+        ...(opts.user !== undefined && { user: String(opts.user) }),
+        ...(opts.componentsScope !== undefined && { componentsScope: String(opts.componentsScope) }),
+    };
+}
+/** Test-only: reset module state between specs. */
+function _resetForTests() {
+    (0, loop_ts_1._resetInFlightForTests)();
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent/agent.js.map

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