@agent-finops/core 0.5.7 → 0.5.8

package/README.md

@@ -1,6 +1,6 @@
 # @agent-finops/core
 
-The canonical local-first data and decision engine for
+The canonical local-first evidence and decision engine for
 [aibill](https://github.com/futurastudio/ai-spend-agent): Claude Code/Codex
 activity ingestion, provider cost semantics, attribution, provenance, runway,
 Context Health, and the shared Glance contract.
@@ -8,6 +8,10 @@ Context Health, and the shared Glance contract.
 Most users should run `npx aibill`. This package is for integrations that
 need the same evidence-labeled calculations as the CLI and MCP server.
 
+This is the open foundation for aibill's financial-accountability mission. It
+does not yet implement company-wide ownership, accepted outcomes, approvals,
+invoice reconciliation, or ROI.
+
 Local API-equivalent estimates, subscription context, and official
 provider-reported cost are separate concepts and must not be added together.
 

package/dist/analyze.js

@@ -147,7 +147,7 @@ export function generateRecommendations(records) {
             id: "model-downgrade",
             title: "Review expensive model workloads for downgrade candidates",
             rationale: `${topModel.key} is the largest cost driver in the current local sample.`,
-            whyItMatters: "Premium model usage tends to become invisible once agents are running in the background. Board owners need a clear rule for which jobs deserve the expensive model.",
+            whyItMatters: "Premium model usage tends to become invisible once agents are running in the background. Spend owners need a clear rule for which jobs deserve the expensive model.",
             nextAction: `Audit the top ${topModel.key} operations and move low-risk summarization, extraction, and draft work to a cheaper model tier first.`,
             priority: "high",
             estimatedImpactUsd: roundMoney(topModel.amountUsd * impactRatios.modelDowngrade),

package/dist/attribution.js

@@ -26,7 +26,7 @@ export function attributeUsageRecords(records) {
 }
 function buildCandidates(record) {
     const candidates = [];
-    if (record.projectId) {
+    if (record.projectId && !isPlaceholderEntityId(record.projectId)) {
         candidates.push({
             entityType: "project",
             entityId: record.projectId,
@@ -34,7 +34,7 @@ function buildCandidates(record) {
             evidence: [`usage record includes projectId ${record.projectId}`]
         });
     }
-    if (record.clientId) {
+    if (record.clientId && !isPlaceholderEntityId(record.clientId)) {
         candidates.push({
             entityType: "client",
             entityId: record.clientId,
@@ -42,7 +42,7 @@ function buildCandidates(record) {
             evidence: [`usage record includes clientId ${record.clientId}`]
         });
     }
-    if (record.agentId) {
+    if (record.agentId && !isPlaceholderEntityId(record.agentId)) {
         candidates.push({
             entityType: "agent",
             entityId: record.agentId,
@@ -50,7 +50,7 @@ function buildCandidates(record) {
             evidence: [`usage record includes agentId ${record.agentId}`]
         });
     }
-    if (record.userId) {
+    if (record.userId && !isPlaceholderEntityId(record.userId)) {
         candidates.push({
             entityType: "user",
             entityId: record.userId,
@@ -58,7 +58,7 @@ function buildCandidates(record) {
             evidence: [`usage record includes userId ${record.userId}`]
         });
     }
-    if (record.workspaceId) {
+    if (record.workspaceId && !isPlaceholderEntityId(record.workspaceId)) {
         candidates.push({
             entityType: "workspace",
             entityId: record.workspaceId,
@@ -66,7 +66,7 @@ function buildCandidates(record) {
             evidence: [`usage record includes workspaceId ${record.workspaceId}`]
         });
     }
-    if (record.apiKeyId) {
+    if (record.apiKeyId && !isPlaceholderEntityId(record.apiKeyId)) {
         candidates.push({
             entityType: "api_key",
             entityId: record.apiKeyId,
@@ -103,6 +103,9 @@ function buildCandidates(record) {
     }
     return dedupeCandidates(candidates);
 }
+function isPlaceholderEntityId(value) {
+    return ["(home)", "home", "unknown", "unattributed", "unmapped", "(unmapped)"].includes(value.trim().toLowerCase());
+}
 function dedupeCandidates(candidates) {
     const byKey = new Map();
     for (const candidate of candidates) {

package/dist/localAgentLogs.js

@@ -146,6 +146,12 @@ export function parseCodexRollout(content) {
                 const normalized = resolve(workdir);
                 toolWorkdirs.set(normalized, (toolWorkdirs.get(normalized) ?? 0) + 1);
             }
+            // Current Codex Desktop records the orchestration wrapper as a custom
+            // `exec` call whose input is JavaScript containing nested tool calls.
+            // Extract only quoted absolute workdir/cwd values; never evaluate it.
+            if (payload.type === "custom_tool_call" && stringOf(payload.name) === "exec") {
+                collectEmbeddedToolWorkdirs(stringOf(payload.input), toolWorkdirs);
+            }
             collectToolFiles(args, fileCounts);
             collectPatchFiles(stringOf(args?.patch) ?? stringOf(args?.input) ?? stringOf(payload.input), fileCounts);
         }
@@ -199,6 +205,24 @@ export function parseCodexRollout(content) {
             }
         }];
 }
+function collectEmbeddedToolWorkdirs(input, toolWorkdirs) {
+    if (!input)
+        return;
+    const fieldPattern = /(?:^|[^A-Za-z0-9_])["']?(?:workdir|cwd)["']?\s*:\s*("(?:\\.|[^"\\])*")/g;
+    for (const match of input.matchAll(fieldPattern)) {
+        let value;
+        try {
+            value = JSON.parse(match[1]);
+        }
+        catch {
+            continue;
+        }
+        if (typeof value !== "string" || !isAbsolute(value))
+            continue;
+        const normalized = resolve(value);
+        toolWorkdirs.set(normalized, (toolWorkdirs.get(normalized) ?? 0) + 1);
+    }
+}
 function parseCodexRateLimits(value, observedAt) {
     if (!isRecord(value) || !observedAt)
         return undefined;
@@ -314,7 +338,10 @@ export function aggregateCalls(calls) {
             outputTokens: usage.outputTokens,
             amountUsd: priced ? amountUsd : null,
             costConfidence: priced ? "estimated" : "missing",
-            projectId: project === "unattributed" ? undefined : project,
+            // `(home)` is an attribution fallback, not a real project. Keep it on
+            // LocalAgentCall for Glance/session context, but do not promote it to a
+            // high-confidence project id in receipts or the attribution engine.
+            projectId: project === "unattributed" || project === "(home)" ? undefined : project,
             agentId: agent,
             providerCostType: "local_agent_logs",
             quantity: groupCalls.length,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-finops/core",
-  "version": "0.5.7",
+  "version": "0.5.8",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -20,7 +20,7 @@
     "!dist/**/*.tsbuildinfo"
   ],
   "license": "MIT",
-  "description": "Canonical aibill engine for local agent activity, billing semantics, attribution, provenance, runway, and Context Health.",
+  "description": "Canonical aibill evidence engine for agent work, billing semantics, attribution, provenance, runway, and Context Health.",
   "keywords": [
     "ai",
     "finops",