@agenthifive/openclaw 0.1.0

package/dist/pending-approvals.js

@@ -0,0 +1,95 @@
+/**
+ * State file for tracking pending vault step-up approvals.
+ *
+ * When the vault_execute agent tool gets a 202 (approval required), it writes
+ * the pending approval to {stateDir}/vault-pending-approvals.json.
+ *
+ * The before_agent_start hook reads this file on each turn, polls the AH5 API
+ * for resolved approvals, and injects notifications into the agent's context
+ * so it can re-submit approved requests and continue multi-step plans.
+ *
+ * Unlike the fork version, this module accepts `stateDir` as a parameter
+ * instead of importing from OpenClaw's config/paths.
+ */
+import { readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+const PENDING_FILE = "vault-pending-approvals.json";
+const FALLBACK_FILE = "vault-resolved-notifications.json";
+let _stateDir = null;
+let _log = console;
+/**
+ * Initialize the pending approvals module with a state directory and logger.
+ * Must be called before any other function in this module.
+ */
+export function initPendingApprovals(stateDir, logger) {
+    _stateDir = stateDir;
+    if (logger)
+        _log = logger;
+}
+function getStateDir() {
+    if (!_stateDir) {
+        throw new Error("pending-approvals not initialized — call initPendingApprovals() first");
+    }
+    return _stateDir;
+}
+/**
+ * Add a pending approval to the state file.
+ * Called by the vault_execute tool when it receives a 202.
+ */
+export function addPendingApproval(approval) {
+    try {
+        const existing = loadPendingApprovals();
+        if (existing.some((a) => a.approvalRequestId === approval.approvalRequestId)) {
+            return;
+        }
+        existing.push(approval);
+        savePendingApprovals(existing);
+        _log.info?.(`tracked pending approval ${approval.approvalRequestId} (${approval.summary})`);
+    }
+    catch (err) {
+        _log.error?.(`failed to track pending approval: ${String(err)}`);
+    }
+}
+export function loadPendingApprovals() {
+    try {
+        const data = readFileSync(join(getStateDir(), PENDING_FILE), "utf-8");
+        const parsed = JSON.parse(data);
+        if (Array.isArray(parsed)) {
+            return parsed;
+        }
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+export function savePendingApprovals(approvals) {
+    try {
+        writeFileSync(join(getStateDir(), PENDING_FILE), JSON.stringify(approvals, null, 2), "utf-8");
+    }
+    catch (err) {
+        _log.error?.(`failed to save pending approvals: ${String(err)}`);
+    }
+}
+export function loadFallbackNotifications() {
+    try {
+        const data = readFileSync(join(getStateDir(), FALLBACK_FILE), "utf-8");
+        const parsed = JSON.parse(data);
+        if (Array.isArray(parsed)) {
+            return parsed;
+        }
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+export function saveFallbackNotifications(notifications) {
+    try {
+        writeFileSync(join(getStateDir(), FALLBACK_FILE), JSON.stringify(notifications, null, 2), "utf-8");
+    }
+    catch (err) {
+        _log.error?.(`failed to save fallback notifications: ${String(err)}`);
+    }
+}
+//# sourceMappingURL=pending-approvals.js.map

package/dist/pending-approvals.js.map

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

package/dist/prompt-reference.d.ts

@@ -0,0 +1,51 @@
+/**
+ * AgentHiFive Vault Prompt Reference — Chunked Architecture
+ *
+ * Provides two modes of API reference injection:
+ *
+ * 1. **Inline mode** (`buildApiReferencePrompt`): Assembles a single prompt
+ *    string from provider sections. Used by the MCP server and simple consumers.
+ *
+ * 2. **Chunked file mode** (`writeReferenceFiles`): Writes a base reference
+ *    file (tools, permissions, action templates) plus per-service API reference
+ *    files to a state directory. The system prompt then contains a lean pointer
+ *    listing available files. Used by the OpenClaw plugin for better accuracy.
+ *
+ * Chunked > monolithic: eval showed 89% accuracy (chunked) vs 72% (monolithic)
+ * with realistic production-sized prompts. Models get overwhelmed when all
+ * provider API docs are in one blob.
+ */
+export declare const API_REFERENCE_SECTIONS: Record<string, string>;
+/**
+ * Build an API reference prompt from the given provider names.
+ *
+ * Only includes sections for providers that have entries in
+ * `API_REFERENCE_SECTIONS`. Unknown providers are silently ignored.
+ */
+export declare function buildApiReferencePrompt(providers: string[]): string;
+/**
+ * Full API reference prompt with all providers.
+ * Kept for backwards compatibility and programmatic access.
+ */
+export declare const API_REFERENCE_PROMPT: string;
+export declare const CHUNKED_API_SECTIONS: Record<string, string>;
+/**
+ * Write chunked reference files to a state directory.
+ *
+ * - Base file (vault-reference.md): tools, permission flow, action templates, notes
+ * - Per-service files (vault-ref-{service}.md): API docs for each provider
+ *
+ * Returns the paths so the system prompt can list them.
+ */
+export declare function writeReferenceFiles(stateDir: string, logger?: {
+    info?: (...args: unknown[]) => void;
+}): {
+    basePath: string;
+    serviceFiles: string[];
+};
+/**
+ * Build the lean system prompt that points to the chunked reference files.
+ * Injected via the before_agent_start / before_prompt_build hook.
+ */
+export declare function buildChunkedPrompt(basePath: string, serviceFiles: string[]): string;
+//# sourceMappingURL=prompt-reference.d.ts.map

package/dist/prompt-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-reference.d.ts","sourceRoot":"","sources":["../src/prompt-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAkCH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwGzD,CAAC;AAMF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAenE;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAEhC,CAAC;AAwIF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmSvD,CAAC;AAMF;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CAAE,GAC/C;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CA+BA;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAkBnF"}