@agentguard-run/spend 0.3.0 → 0.4.1

package/dist/advisor/forecast.d.ts

@@ -0,0 +1,19 @@
+/**
+ * AgentGuard(TM) Spend: local Advisor forecast skeleton.
+ *
+ * Reads local decision logs only. No network calls are made.
+ *
+ * Patent notice: Protected by U.S. patent-pending technology
+ * (App. Nos. 63/983,615; 63/983,621; 63/983,843; 63/984,626;
+ * 64/071,781; 64/071,789).
+ */
+import type { AdvisorSpendPoint } from './anomaly';
+export interface AdvisorForecast {
+    daysObserved: number;
+    monthEndCents: number;
+    capCents: number | null;
+    overCap: boolean;
+    message: string;
+}
+export declare function forecastMonthEnd(points: AdvisorSpendPoint[], capCents?: number | null, now?: Date): AdvisorForecast;
+//# sourceMappingURL=forecast.d.ts.map

package/dist/advisor/forecast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forecast.d.ts","sourceRoot":"","sources":["../../src/advisor/forecast.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,EAAE,GAAG,OAAa,GAAG,eAAe,CAoB/H"}

package/dist/advisor/forecast.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * AgentGuard(TM) Spend: local Advisor forecast skeleton.
+ *
+ * Reads local decision logs only. No network calls are made.
+ *
+ * Patent notice: Protected by U.S. patent-pending technology
+ * (App. Nos. 63/983,615; 63/983,621; 63/983,843; 63/984,626;
+ * 64/071,781; 64/071,789).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forecastMonthEnd = forecastMonthEnd;
+function forecastMonthEnd(points, capCents = null, now = new Date()) {
+    const daily = lastThirtyDaily(points, now);
+    if (daily.length === 0) {
+        return { daysObserved: 0, monthEndCents: 0, capCents, overCap: false, message: 'No local spend history found.' };
+    }
+    const slope = linearSlope(daily.map((row, index) => ({ x: index + 1, y: row.cents })));
+    const monthDays = new Date(now.getFullYear(), now.getMonth() + 1, 0).getDate();
+    const elapsed = now.getDate();
+    const observedTotal = daily.reduce((sum, row) => sum + row.cents, 0);
+    const avg = observedTotal / Math.max(1, daily.length);
+    const projectedRemaining = Math.max(0, monthDays - elapsed) * Math.max(0, avg + slope);
+    const monthEndCents = Math.round(observedTotal + projectedRemaining);
+    const overCap = capCents !== null && monthEndCents > capCents;
+    return {
+        daysObserved: daily.length,
+        monthEndCents,
+        capCents,
+        overCap,
+        message: overCap ? 'Projected spend is above cap. Consider a lower fallback model or a tighter per_day cap.' : 'Projected spend is within the current cap.',
+    };
+}
+function lastThirtyDaily(points, now) {
+    const cutoff = now.getTime() - 30 * 24 * 60 * 60 * 1000;
+    const buckets = new Map();
+    for (const point of points) {
+        const t = Date.parse(point.ts);
+        if (!Number.isFinite(t) || t < cutoff)
+            continue;
+        const day = new Date(t).toISOString().slice(0, 10);
+        buckets.set(day, (buckets.get(day) ?? 0) + point.cents);
+    }
+    return [...buckets.entries()].map(([day, cents]) => ({ day, cents })).sort((a, b) => a.day.localeCompare(b.day));
+}
+function linearSlope(points) {
+    if (points.length < 2)
+        return 0;
+    const n = points.length;
+    const sx = points.reduce((sum, point) => sum + point.x, 0);
+    const sy = points.reduce((sum, point) => sum + point.y, 0);
+    const sxx = points.reduce((sum, point) => sum + point.x * point.x, 0);
+    const sxy = points.reduce((sum, point) => sum + point.x * point.y, 0);
+    const denom = n * sxx - sx * sx;
+    return denom === 0 ? 0 : (n * sxy - sx * sy) / denom;
+}
+//# sourceMappingURL=forecast.js.map

package/dist/advisor/forecast.js.map

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

package/dist/advisor/llm-client.d.ts

@@ -0,0 +1,41 @@
+/**
+ * AgentGuard(TM) Spend: local Advisor LLM client.
+ *
+ * All provider calls go from the customer terminal to the configured provider.
+ * No AgentGuard service is contacted for prompts or completions.
+ *
+ * Patent notice: Protected by U.S. patent-pending technology
+ * (App. Nos. 63/983,615; 63/983,621; 63/983,843; 63/984,626;
+ * 64/071,781; 64/071,789).
+ */
+export type AdvisorProvider = 'openrouter' | 'openai' | 'anthropic' | 'compatible' | 'mock';
+export interface AdvisorChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface AdvisorClientOptions {
+    provider?: AdvisorProvider;
+    apiKey?: string;
+    baseUrl?: string;
+    model?: string;
+    timeoutMs?: number;
+    fetchImpl?: FetchLike;
+}
+export interface AdvisorClient {
+    provider: AdvisorProvider;
+    model: string;
+    baseUrl: string;
+    streamChat(messages: AdvisorChatMessage[], signal?: AbortSignalLike): AsyncIterable<string>;
+}
+type FetchLike = (url: string, init: Record<string, unknown>) => Promise<any>;
+type AbortSignalLike = {
+    aborted?: boolean;
+    addEventListener?: (type: 'abort', listener: () => void, options?: {
+        once?: boolean;
+    }) => void;
+};
+export declare function resolveAdvisorApiKey(provider?: AdvisorProvider, explicit?: string): string | null;
+export declare function createAdvisorClient(options?: AdvisorClientOptions): AdvisorClient;
+export declare function parseSseResponse(response: any, pickText: (json: any) => string): AsyncIterable<string>;
+export {};
+//# sourceMappingURL=llm-client.d.ts.map

package/dist/advisor/llm-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-client.d.ts","sourceRoot":"","sources":["../../src/advisor/llm-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,MAAM,CAAC;AAE5F,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,QAAQ,EAAE,kBAAkB,EAAE,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;CAC7F;AAED,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAE9E,KAAK,eAAe,GAAG;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAChG,CAAC;AAYF,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,eAA8B,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY/G;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAwBrF;AAiED,wBAAuB,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAmB7G"}

package/dist/advisor/llm-client.js

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * AgentGuard(TM) Spend: local Advisor LLM client.
+ *
+ * All provider calls go from the customer terminal to the configured provider.
+ * No AgentGuard service is contacted for prompts or completions.
+ *
+ * Patent notice: Protected by U.S. patent-pending technology
+ * (App. Nos. 63/983,615; 63/983,621; 63/983,843; 63/984,626;
+ * 64/071,781; 64/071,789).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAdvisorApiKey = resolveAdvisorApiKey;
+exports.createAdvisorClient = createAdvisorClient;
+exports.parseSseResponse = parseSseResponse;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const DEFAULT_OPENROUTER_BASE_URL = 'https://openrouter.ai/api/v1';
+const DEFAULT_OPENAI_BASE_URL = 'https://api.openai.com/v1';
+const DEFAULT_ANTHROPIC_BASE_URL = 'https://api.anthropic.com/v1';
+const DEFAULT_MODEL = 'openai/gpt-4o-mini';
+function resolveAdvisorApiKey(provider = 'openrouter', explicit) {
+    if (explicit?.trim())
+        return explicit.trim();
+    if (provider === 'openai' && process.env.OPENAI_API_KEY)
+        return process.env.OPENAI_API_KEY;
+    if (provider === 'anthropic' && process.env.ANTHROPIC_API_KEY)
+        return process.env.ANTHROPIC_API_KEY;
+    if ((provider === 'openrouter' || provider === 'compatible') && process.env.OPENROUTER_API_KEY)
+        return process.env.OPENROUTER_API_KEY;
+    if (process.env.AGENTGUARD_ADVISOR_API_KEY)
+        return process.env.AGENTGUARD_ADVISOR_API_KEY;
+    try {
+        const key = fs.readFileSync(path.join(agentguardHome(), 'openrouter-key'), 'utf8').trim();
+        return key.length > 0 ? key : null;
+    }
+    catch {
+        return null;
+    }
+}
+function createAdvisorClient(options = {}) {
+    const provider = options.provider ?? providerFromBaseUrl(options.baseUrl) ?? 'openrouter';
+    const model = options.model ?? (provider === 'anthropic' ? 'claude-sonnet-4-6' : DEFAULT_MODEL);
+    const baseUrl = normalizeBaseUrl(options.baseUrl ?? defaultBaseUrl(provider));
+    const fetchImpl = options.fetchImpl ?? globalFetch;
+    const apiKey = resolveAdvisorApiKey(provider, options.apiKey);
+    return {
+        provider,
+        model,
+        baseUrl,
+        async *streamChat(messages, signal) {
+            if (provider === 'mock') {
+                yield 'Mock advisor response.';
+                return;
+            }
+            if (!apiKey)
+                throw new Error('No Advisor API key configured');
+            if (provider === 'anthropic') {
+                yield* streamAnthropic({ fetchImpl, baseUrl, model, apiKey, messages, signal, timeoutMs: options.timeoutMs });
+            }
+            else {
+                yield* streamOpenAICompatible({ fetchImpl, baseUrl, model, apiKey, messages, signal, timeoutMs: options.timeoutMs });
+            }
+        },
+    };
+}
+async function* streamOpenAICompatible(args) {
+    const controller = createAbortController();
+    const timer = setTimeout(() => controller.abort(), args.timeoutMs ?? 120_000);
+    const signal = mergeSignal(args.signal, controller.signal);
+    try {
+        const response = await args.fetchImpl(`${args.baseUrl}/chat/completions`, {
+            method: 'POST',
+            headers: {
+                authorization: `Bearer ${args.apiKey}`,
+                'content-type': 'application/json',
+                accept: 'text/event-stream',
+            },
+            body: JSON.stringify({ model: args.model, messages: args.messages, stream: true }),
+            signal,
+        });
+        if (!response.ok)
+            throw new Error(`Advisor provider HTTP ${response.status}`);
+        yield* parseSseResponse(response, (json) => json?.choices?.[0]?.delta?.content ?? json?.choices?.[0]?.message?.content ?? '');
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function* streamAnthropic(args) {
+    const controller = createAbortController();
+    const timer = setTimeout(() => controller.abort(), args.timeoutMs ?? 120_000);
+    const signal = mergeSignal(args.signal, controller.signal);
+    try {
+        const system = args.messages.find((m) => m.role === 'system')?.content ?? '';
+        const messages = args.messages.filter((m) => m.role !== 'system').map((m) => ({ role: m.role === 'assistant' ? 'assistant' : 'user', content: m.content }));
+        const response = await args.fetchImpl(`${args.baseUrl}/messages`, {
+            method: 'POST',
+            headers: {
+                'x-api-key': args.apiKey,
+                'anthropic-version': '2023-06-01',
+                'content-type': 'application/json',
+                accept: 'text/event-stream',
+            },
+            body: JSON.stringify({ model: args.model, system, messages, max_tokens: 1200, stream: true }),
+            signal,
+        });
+        if (!response.ok)
+            throw new Error(`Advisor provider HTTP ${response.status}`);
+        yield* parseSseResponse(response, (json) => json?.delta?.text ?? json?.content_block?.text ?? '');
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function* parseSseResponse(response, pickText) {
+    let buffer = '';
+    for await (const chunk of responseBodyIterable(response)) {
+        buffer += chunk;
+        const parts = buffer.split('\n\n');
+        buffer = parts.pop() ?? '';
+        for (const part of parts) {
+            const dataLines = part.split('\n').filter((line) => line.startsWith('data:')).map((line) => line.slice(5).trim());
+            for (const data of dataLines) {
+                if (!data || data === '[DONE]')
+                    continue;
+                try {
+                    const token = pickText(JSON.parse(data));
+                    if (token)
+                        yield token;
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+    }
+}
+async function* responseBodyIterable(response) {
+    const body = response.body;
+    if (!body)
+        return;
+    if (typeof body[Symbol.asyncIterator] === 'function') {
+        for await (const chunk of body)
+            yield chunkToString(chunk);
+        return;
+    }
+    if (typeof body.getReader === 'function') {
+        const reader = body.getReader();
+        const decoder = new TextDecoder();
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            yield decoder.decode(value, { stream: true });
+        }
+    }
+}
+function chunkToString(chunk) {
+    if (typeof chunk === 'string')
+        return chunk;
+    if (chunk instanceof Uint8Array)
+        return Buffer.from(chunk).toString('utf8');
+    return String(chunk ?? '');
+}
+function defaultBaseUrl(provider) {
+    if (provider === 'openai')
+        return DEFAULT_OPENAI_BASE_URL;
+    if (provider === 'anthropic')
+        return DEFAULT_ANTHROPIC_BASE_URL;
+    return DEFAULT_OPENROUTER_BASE_URL;
+}
+function normalizeBaseUrl(value) {
+    return value.replace(/\/+$/, '');
+}
+function providerFromBaseUrl(baseUrl) {
+    if (!baseUrl)
+        return null;
+    if (baseUrl.includes('anthropic.com'))
+        return 'anthropic';
+    if (baseUrl.includes('openai.com'))
+        return 'openai';
+    if (baseUrl.includes('openrouter.ai'))
+        return 'openrouter';
+    return 'compatible';
+}
+function agentguardHome() {
+    return process.env.AGENTGUARD_HOME || path.join(os.homedir(), '.agentguard');
+}
+function globalFetch(url, init) {
+    const fetchImpl = globalThis.fetch;
+    if (typeof fetchImpl !== 'function')
+        throw new Error('Global fetch is not available. Use Node 20 or newer.');
+    return fetchImpl(url, init);
+}
+function createAbortController() {
+    const Controller = globalThis.AbortController;
+    if (Controller)
+        return new Controller();
+    const signal = { aborted: false, addEventListener: () => undefined };
+    return { signal, abort: () => { signal.aborted = true; } };
+}
+function mergeSignal(a, b) {
+    if (!a)
+        return b;
+    if (a.aborted)
+        return a;
+    const controller = createAbortController();
+    const abort = () => controller.abort();
+    a.addEventListener?.('abort', abort, { once: true });
+    b.addEventListener?.('abort', abort, { once: true });
+    return controller.signal;
+}
+//# sourceMappingURL=llm-client.js.map

package/dist/advisor/llm-client.js.map

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

package/dist/advisor/output.d.ts

@@ -0,0 +1,41 @@
+/**
+ * AgentGuard(TM) Spend: Advisor output writers.
+ *
+ * Files are written locally under ~/.agentguard by default. Conversation logs
+ * stay in ~/.agentguard/advisor-sessions and are never uploaded by this SDK.
+ *
+ * Patent notice: Protected by U.S. patent-pending technology
+ * (App. Nos. 63/983,615; 63/983,621; 63/983,843; 63/984,626;
+ * 64/071,781; 64/071,789).
+ */
+import type { SpendPolicy } from '../types';
+import { type AdvisorBusinessProfile, type ProjectedSavings } from './conversation';
+export interface AdvisorOutputOptions {
+    home?: string;
+    now?: Date;
+    language?: 'ts' | 'py';
+    overwrite?: boolean;
+}
+export interface AdvisorOutputs {
+    policy: SpendPolicy;
+    policyPath: string;
+    quickstartPath: string;
+    sessionDir: string;
+    savings: ProjectedSavings;
+    policyYaml: string;
+    quickstartCode: string;
+    savingsTable: string;
+}
+export interface AdvisorSessionLogger {
+    path: string;
+    append: (event: string, payload?: Record<string, unknown>) => void;
+}
+export declare function agentguardHome(): string;
+export declare function advisorSessionDir(home?: string): string;
+export declare function createAdvisorSessionLogger(home?: string, now?: Date): AdvisorSessionLogger;
+export declare function writeAdvisorOutputs(profile: AdvisorBusinessProfile, options?: AdvisorOutputOptions): AdvisorOutputs;
+export declare function renderPolicyYaml(policy: SpendPolicy, profile: AdvisorBusinessProfile, now?: Date): string;
+export declare function renderQuickstartTs(policy: SpendPolicy, profile: AdvisorBusinessProfile): string;
+export declare function renderQuickstartPy(policy: SpendPolicy, profile: AdvisorBusinessProfile): string;
+export declare function renderSavingsTable(savings: ProjectedSavings): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/advisor/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/advisor/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACpE;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,SAAmB,GAAG,MAAM,CAEjE;AAED,wBAAgB,0BAA0B,CAAC,IAAI,SAAmB,EAAE,GAAG,OAAa,GAAG,oBAAoB,CAa1G;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,EAAE,OAAO,GAAE,oBAAyB,GAAG,cAAc,CAuBvH;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,sBAAsB,EAAE,GAAG,OAAa,GAAG,MAAM,CAyC/G;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAE/F;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAO/F;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAQpE"}

package/dist/advisor/output.js

@@ -0,0 +1,202 @@
+"use strict";
+/**
+ * AgentGuard(TM) Spend: Advisor output writers.
+ *
+ * Files are written locally under ~/.agentguard by default. Conversation logs
+ * stay in ~/.agentguard/advisor-sessions and are never uploaded by this SDK.
+ *
+ * Patent notice: Protected by U.S. patent-pending technology
+ * (App. Nos. 63/983,615; 63/983,621; 63/983,843; 63/984,626;
+ * 64/071,781; 64/071,789).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentguardHome = agentguardHome;
+exports.advisorSessionDir = advisorSessionDir;
+exports.createAdvisorSessionLogger = createAdvisorSessionLogger;
+exports.writeAdvisorOutputs = writeAdvisorOutputs;
+exports.renderPolicyYaml = renderPolicyYaml;
+exports.renderQuickstartTs = renderQuickstartTs;
+exports.renderQuickstartPy = renderQuickstartPy;
+exports.renderSavingsTable = renderSavingsTable;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const conversation_1 = require("./conversation");
+const posture_1 = require("./posture");
+function agentguardHome() {
+    return process.env.AGENTGUARD_HOME || path.join(os.homedir(), '.agentguard');
+}
+function advisorSessionDir(home = agentguardHome()) {
+    return path.join(home, 'advisor-sessions');
+}
+function createAdvisorSessionLogger(home = agentguardHome(), now = new Date()) {
+    const dir = advisorSessionDir(home);
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const stamp = now.toISOString().replace(/[:.]/g, '-');
+    const file = path.join(dir, `${stamp}.jsonl`);
+    fs.closeSync(fs.openSync(file, 'a', 0o600));
+    return {
+        path: file,
+        append(event, payload = {}) {
+            const line = JSON.stringify({ ts: new Date().toISOString(), event, ...payload }) + '\n';
+            fs.appendFileSync(file, line, { encoding: 'utf8', mode: 0o600 });
+        },
+    };
+}
+function writeAdvisorOutputs(profile, options = {}) {
+    const home = options.home ?? agentguardHome();
+    const language = options.language ?? profile.language;
+    const sessionDir = advisorSessionDir(home);
+    fs.mkdirSync(home, { recursive: true, mode: 0o700 });
+    fs.mkdirSync(sessionDir, { recursive: true, mode: 0o700 });
+    const policy = (0, conversation_1.buildPolicyFromProfile)(profile);
+    const policyPath = path.join(home, 'policy.yaml');
+    const quickstartPath = path.join(home, language === 'py' ? 'quickstart.py' : 'quickstart.ts');
+    const savings = (0, conversation_1.projectedSavings)(profile);
+    const policyYaml = renderPolicyYaml(policy, profile, options.now ?? new Date());
+    const quickstartCode = language === 'py' ? renderQuickstartPy(policy, profile) : renderQuickstartTs(policy, profile);
+    const savingsTable = renderSavingsTable(savings);
+    if (!options.overwrite) {
+        assertWritableTarget(policyPath);
+        assertWritableTarget(quickstartPath);
+    }
+    atomicWrite(policyPath, policyYaml, 0o600);
+    atomicWrite(quickstartPath, quickstartCode, 0o600);
+    return { policy, policyPath, quickstartPath, sessionDir, savings, policyYaml, quickstartCode, savingsTable };
+}
+function renderPolicyYaml(policy, profile, now = new Date()) {
+    const caps = policy.caps.map((cap) => {
+        const lines = [
+            `  # WHY: ${whyForWindow(cap.window)}`,
+            `  - amountCents: ${cap.amountCents}`,
+            `    window: ${cap.window}`,
+            `    action: ${cap.action}`,
+        ];
+        if (cap.downgradeTo)
+            lines.push(`    downgradeTo: ${cap.downgradeTo}`);
+        if (cap.reason)
+            lines.push(`    reason: ${quoteYaml(cap.reason)}`);
+        return lines.join('\n');
+    }).join('\n');
+    const tasks = profile.tasks.map((task) => `  - ${quoteYaml(task)}`).join('\n');
+    const posture = (0, posture_1.postureProfile)(profile.posture);
+    const canary = posture.canaryPercent === undefined ? '' : `  canaryPercent: ${posture.canaryPercent}\n`;
+    return `# AgentGuard Spend policy generated by agentguard advisor
+# Generated at: ${now.toISOString()}
+# Scope key: ${profile.scopeLabel}
+id: ${policy.id}
+name: ${quoteYaml(policy.name)}
+version: ${policy.version}
+effectiveFrom: ${quoteYaml(policy.effectiveFrom)}
+mode: ${policy.mode}
+requiredCapability: ${policy.requiredCapability ?? 'read_only'}
+scope:
+  tenantId: ${quoteYaml(policy.scope.tenantId)}
+models:
+  primary: ${profile.primaryModel}
+  fallback: ${profile.fallbackModel}
+governancePosture:
+  posture: ${profile.posture}
+  auditRetentionDays: ${posture.auditRetentionDays}
+  approvalGates: ${posture.approvalGates}
+  downgradeStyle: ${posture.downgradeStyle}
+${canary}tasks:
+${tasks}
+caps:
+${caps}
+systemInstructions: |
+${indent(systemInstructions(profile), 2)}
+`;
+}
+function renderQuickstartTs(policy, profile) {
+    return `import OpenAI from 'openai';\nimport { withSpendGuard, type SpendPolicy } from '@agentguard-run/spend';\n\nconst policy: SpendPolicy = ${JSON.stringify(policy, null, 2)};\n\nconst openrouter = new OpenAI({\n  baseURL: 'https://openrouter.ai/api/v1',\n  apiKey: process.env.OPENROUTER_API_KEY,\n});\n\nexport const guardedClient = withSpendGuard(openrouter, {\n  policy,\n  scope: { tenantId: '${escapeTs(profile.tenantId)}', agentId: '${escapeTs(profile.vertical)}' },\n  capabilityClaim: '${policy.requiredCapability ?? 'read_only'}',\n});\n\nexport async function runGuardedTask(prompt: string) {\n  return guardedClient.chat.completions.create({\n    model: '${escapeTs(profile.primaryModel)}',\n    messages: [{ role: 'user', content: prompt }],\n  });\n}\n`;
+}
+function renderQuickstartPy(policy, profile) {
+    const caps = policy.caps.map((cap) => {
+        const args = [`amountCents=${cap.amountCents}`, `window='${cap.window}'`, `action='${cap.action}'`];
+        if (cap.downgradeTo)
+            args.push(`downgradeTo='${escapePy(cap.downgradeTo)}'`);
+        return `        SpendCap(${args.join(', ')}),`;
+    }).join('\n');
+    return `from openai import OpenAI\nfrom agentguard_spend import with_spend_guard\nfrom agentguard_spend.types import SpendPolicy, SpendCap\n\npolicy = SpendPolicy(\n    id='${escapePy(policy.id)}',\n    name='${escapePy(policy.name)}',\n    scope={'tenantId': '${escapePy(profile.tenantId)}'},\n    caps=[\n${caps}\n    ],\n    mode='${policy.mode}',\n    requiredCapability='${policy.requiredCapability ?? 'read_only'}',\n    version=${policy.version},\n    effectiveFrom='${escapePy(policy.effectiveFrom)}',\n)\n\nopenrouter = OpenAI(base_url='https://openrouter.ai/api/v1')\nguarded_client = with_spend_guard(\n    openrouter,\n    policy=policy,\n    scope={'tenantId': '${escapePy(profile.tenantId)}', 'agentId': '${escapePy(profile.vertical)}'},\n    capability_claim='${policy.requiredCapability ?? 'read_only'}',\n)\n`;
+}
+function renderSavingsTable(savings) {
+    const rows = [
+        'Projected monthly savings',
+        `Before AgentGuard: ${(0, conversation_1.formatCents)(savings.monthlyBeforeCents)}`,
+        `After AgentGuard:  ${(0, conversation_1.formatCents)(savings.monthlyAfterCents)}`,
+        `Savings:           ${(0, conversation_1.formatCents)(savings.monthlySavingsCents)} (${savings.savingsPercent}%)`,
+    ];
+    return rows.join('\n');
+}
+function atomicWrite(file, content, mode) {
+    const temp = `${file}.${process.pid}.${Date.now()}.tmp`;
+    fs.writeFileSync(temp, content, { encoding: 'utf8', mode });
+    fs.renameSync(temp, file);
+    fs.chmodSync(file, mode);
+}
+function assertWritableTarget(file) {
+    if (!fs.existsSync(file))
+        return;
+    fs.accessSync(file, fs.constants.W_OK);
+}
+function whyForWindow(window) {
+    if (window === 'per_call')
+        return 'Bounds one agent action and routes overflow to the fallback model.';
+    if (window === 'per_day')
+        return 'Catches runaway loops and unexpected daily volume.';
+    if (window === 'per_month')
+        return 'Keeps the finance view predictable for the billing cycle.';
+    return 'Limits spend inside the selected time window.';
+}
+function systemInstructions(profile) {
+    const posture = (0, posture_1.postureProfile)(profile.posture);
+    return `Run ${profile.vertical} tasks with ${profile.requiredCapability} capability under ${posture.label} governance posture. Prefer ${profile.primaryModel} for high-value work and ${profile.fallbackModel} for routine work. Keep evidence pointers in outputs and escalate anything outside the configured capability tier.`;
+}
+function quoteYaml(value) {
+    return JSON.stringify(value);
+}
+function indent(value, spaces) {
+    const prefix = ' '.repeat(spaces);
+    return value.split('\n').map((line) => prefix + line).join('\n');
+}
+function escapeTs(value) {
+    return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+function escapePy(value) {
+    return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+//# sourceMappingURL=output.js.map