@agentguard-run/spend 0.2.2 → 0.4.0

package/dist/cli/models.d.ts

@@ -0,0 +1,18 @@
+import { type OpenRouterModel } from '../openrouter-catalog';
+export interface ModelRow {
+    id: string;
+    name: string;
+    inputCentsPerMtok: number | null;
+    outputCentsPerMtok: number | null;
+    capability: string;
+}
+export declare function rowsFromCatalog(models: OpenRouterModel[]): ModelRow[];
+export declare function rowsFromCostTable(): ModelRow[];
+export declare function filterRows(rows: ModelRow[], opts: {
+    search?: string;
+    capability?: string;
+    task?: string;
+}): ModelRow[];
+export declare function suggestedAssignments(task: string): Record<string, string[]>;
+export declare function runModels(argv: string[]): Promise<number>;
+//# sourceMappingURL=models.d.ts.map

package/dist/cli/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/cli/models.ts"],"names":[],"mappings":"AAIA,OAAO,EAA4D,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAKvH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,QAAQ,EAAE,CAYrE;AAED,wBAAgB,iBAAiB,IAAI,QAAQ,EAAE,CAQ9C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,EAAE,CAetH;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAQ3E;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA0C/D"}

package/dist/cli/models.js

@@ -0,0 +1,277 @@
+"use strict";
+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.rowsFromCatalog = rowsFromCatalog;
+exports.rowsFromCostTable = rowsFromCostTable;
+exports.filterRows = filterRows;
+exports.suggestedAssignments = suggestedAssignments;
+exports.runModels = runModels;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
+const index_1 = require("../index");
+const openrouter_catalog_1 = require("../openrouter-catalog");
+const cost_table_1 = require("../cost-table");
+const templates_1 = require("../templates");
+const colors_1 = require("./colors");
+function rowsFromCatalog(models) {
+    return models.map((model) => {
+        const input = Number(model.pricing?.prompt);
+        const output = Number(model.pricing?.completion);
+        return {
+            id: model.id,
+            name: model.name ?? model.id,
+            inputCentsPerMtok: Number.isFinite(input) ? input * 100 * 1_000_000 : null,
+            outputCentsPerMtok: Number.isFinite(output) ? output * 100 * 1_000_000 : null,
+            capability: capabilityForModel(model.id),
+        };
+    });
+}
+function rowsFromCostTable() {
+    return Object.entries((0, cost_table_1.knownModelCosts)()).map(([id, cost]) => ({
+        id,
+        name: id,
+        inputCentsPerMtok: cost.inputCentsPerKtok * 1000,
+        outputCentsPerMtok: cost.outputCentsPerKtok * 1000,
+        capability: capabilityForModel(id),
+    }));
+}
+function filterRows(rows, opts) {
+    let out = rows;
+    if (opts.task) {
+        const template = (0, templates_1.getTaskTemplate)(opts.task);
+        if (template) {
+            const allowed = new Set(template.allowedModels);
+            out = out.filter((row) => allowed.has(row.id) || row.capability === template.requiredCapability);
+        }
+    }
+    if (opts.capability)
+        out = out.filter((row) => row.capability === opts.capability);
+    if (opts.search) {
+        const needle = opts.search.toLowerCase();
+        out = out.filter((row) => row.id.toLowerCase().includes(needle) || row.name.toLowerCase().includes(needle));
+    }
+    return out.sort((a, b) => displayCost(a) - displayCost(b) || a.id.localeCompare(b.id));
+}
+function suggestedAssignments(task) {
+    const template = (0, templates_1.getTaskTemplate)(task);
+    if (!template)
+        return {};
+    return {
+        primary: [template.primaryModel],
+        fallback: [template.fallbackModel],
+        allowed: template.allowedModels,
+    };
+}
+async function runModels(argv) {
+    if (argv.includes('--help') || argv.includes('-h')) {
+        console.log('agentguard models [--sync-pricing] [--search <term>] [--capability <tier>] [--task <template>] [--json]');
+        return 0;
+    }
+    const sync = argv.includes('--sync-pricing');
+    const json = argv.includes('--json');
+    const search = argValue(argv, '--search');
+    const capability = argValue(argv, '--capability');
+    const task = argValue(argv, '--task');
+    if (sync) {
+        const result = await (0, openrouter_catalog_1.syncPricingIntoCostTable)({ force: true });
+        if (json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log('');
+            console.log('  ' + (0, colors_1.banner)(index_1.AGENTGUARD_SPEND_VERSION));
+            console.log('');
+            console.log(`  ${(0, colors_1.green)('applied')} ${result.count} OpenRouter pricing overrides`);
+            console.log(`  ${(0, colors_1.dim)('saved')} ${(0, colors_1.agentguardHome)()}/cost-overrides.json`);
+            console.log('');
+        }
+        return 0;
+    }
+    const rows = await loadRows();
+    const filtered = filterRows(rows, { search, capability, task });
+    if (json) {
+        console.log(JSON.stringify({ models: filtered, assignments: task ? suggestedAssignments(task) : undefined }, null, 2));
+        return 0;
+    }
+    if (process.stdin.isTTY && !search && !capability && !task) {
+        const selected = await interactivePick(filtered);
+        if (selected.length > 0)
+            writeSelectedModels(selected);
+        return 0;
+    }
+    printRows(filtered, task);
+    return 0;
+}
+async function loadRows() {
+    const cached = (0, openrouter_catalog_1.getCachedCatalog)();
+    if (cached)
+        return rowsFromCatalog(cached.data);
+    try {
+        const catalog = await (0, openrouter_catalog_1.fetchCatalog)();
+        return rowsFromCatalog(catalog.data);
+    }
+    catch {
+        return rowsFromCostTable();
+    }
+}
+function printRows(rows, task) {
+    console.log('');
+    console.log('  ' + (0, colors_1.banner)(index_1.AGENTGUARD_SPEND_VERSION));
+    console.log('');
+    if (task && templates_1.TASK_TEMPLATES[task]) {
+        const assignment = suggestedAssignments(task);
+        console.log('  ' + (0, colors_1.cyanBold)(`task: ${task}`));
+        console.log(`  primary: ${assignment.primary?.join(', ') ?? 'n/a'}`);
+        console.log(`  fallback: ${assignment.fallback?.join(', ') ?? 'n/a'}`);
+        console.log('');
+    }
+    for (const row of rows.slice(0, 80)) {
+        console.log(`  ${(0, colors_1.green)(row.id.padEnd(38))} ${formatCost(row).padEnd(22)} ${(0, colors_1.dim)(row.capability)}`);
+    }
+    if (rows.length > 80)
+        console.log(`  ${(0, colors_1.yellow)(String(rows.length - 80) + ' more')}  refine with agentguard models --search <term>`);
+    console.log('');
+    console.log('  ' + (0, colors_1.statusBar)());
+    console.log('');
+}
+async function interactivePick(rows) {
+    const selected = new Set();
+    let cursor = 0;
+    let filtered = rows.slice(0, 80);
+    let query = '';
+    readline.emitKeypressEvents(process.stdin);
+    if (process.stdin.isTTY)
+        process.stdin.setRawMode(true);
+    const render = () => {
+        process.stdout.write('\x1b[2J\x1b[H');
+        console.log((0, colors_1.banner)(index_1.AGENTGUARD_SPEND_VERSION));
+        console.log('');
+        console.log(`Search: ${query || (0, colors_1.dim)('press / to filter')}   Selected: ${selected.size}`);
+        console.log('');
+        filtered.slice(0, 18).forEach((row, index) => {
+            const marker = selected.has(row.id) ? '[x]' : '[ ]';
+            const pointer = index === cursor ? '>' : ' ';
+            console.log(`${pointer} ${marker} ${row.id.padEnd(40)} ${formatCost(row).padEnd(20)} ${row.capability}`);
+        });
+        console.log('');
+        console.log((0, colors_1.dim)('[/] search  [space] select  [enter] confirm  [q] quit'));
+    };
+    render();
+    return new Promise((resolve) => {
+        const onKey = (_chunk, key) => {
+            if (key.name === 'q' || (key.ctrl && key.name === 'c'))
+                finish([]);
+            else if (key.name === 'return')
+                finish([...selected]);
+            else if (key.name === 'down') {
+                cursor = Math.min(cursor + 1, Math.max(0, filtered.length - 1));
+                render();
+            }
+            else if (key.name === 'up') {
+                cursor = Math.max(cursor - 1, 0);
+                render();
+            }
+            else if (key.name === 'space') {
+                const row = filtered[cursor];
+                if (row)
+                    selected.has(row.id) ? selected.delete(row.id) : selected.add(row.id);
+                render();
+            }
+            else if (key.name === 'backspace') {
+                query = query.slice(0, -1);
+                filtered = filterRows(rows, { search: query });
+                cursor = 0;
+                render();
+            }
+            else if (key.sequence && key.sequence.length === 1 && key.sequence !== '/') {
+                query += key.sequence;
+                filtered = filterRows(rows, { search: query });
+                cursor = 0;
+                render();
+            }
+        };
+        const finish = (value) => {
+            process.stdin.off('keypress', onKey);
+            if (process.stdin.isTTY)
+                process.stdin.setRawMode(false);
+            process.stdout.write('\n');
+            resolve(value);
+        };
+        process.stdin.on('keypress', onKey);
+    });
+}
+function writeSelectedModels(models) {
+    const filePath = path.join((0, colors_1.agentguardHome)(), 'policy.yaml');
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    let existing = '';
+    try {
+        existing = fs.readFileSync(filePath, 'utf8');
+    }
+    catch {
+        existing = defaultPolicy();
+    }
+    const block = ['allowedModels:', ...models.map((model) => `  - ${model}`)].join('\n') + '\n';
+    const next = existing.match(/^allowedModels:/m)
+        ? existing.replace(/^allowedModels:\n(?:  - .*\n)*/m, block)
+        : existing.trimEnd() + '\n' + block;
+    fs.writeFileSync(filePath, next);
+    console.log(`${(0, colors_1.green)('saved')} ${filePath}`);
+}
+function defaultPolicy() {
+    return 'id: local-policy-v1\nname: Local AgentGuard policy\nversion: 1\neffectiveFrom: "' + new Date().toISOString() + '"\nmode: enforce\nscope:\n  tenantId: local\ncaps:\n  - amountCents: 100\n    window: per_call\n    action: allow\n';
+}
+function formatCost(row) {
+    if (row.inputCentsPerMtok === null || row.outputCentsPerMtok === null)
+        return '$n/a per 1M';
+    return `$${(row.inputCentsPerMtok / 100).toFixed(2)}/$${(row.outputCentsPerMtok / 100).toFixed(2)} per 1M`;
+}
+function displayCost(row) {
+    return row.inputCentsPerMtok ?? Number.MAX_SAFE_INTEGER;
+}
+function capabilityForModel(model) {
+    if (model.includes('gpt-5') || model.includes('opus') || model.includes('sonnet'))
+        return 'payment_initiate';
+    if (model.includes('mini') || model.includes('haiku') || model.includes('flash'))
+        return 'read_only';
+    if ((0, cost_table_1.getModelCost)(model))
+        return 'data_write';
+    return 'read_only';
+}
+function argValue(argv, flag) {
+    const index = argv.indexOf(flag);
+    return index >= 0 ? argv[index + 1] : undefined;
+}
+//# sourceMappingURL=models.js.map

package/dist/cli/models.js.map

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

package/dist/cli/tips.d.ts

@@ -0,0 +1,21 @@
+export interface AgentGuardTip {
+    id: string;
+    surface: string;
+    severity: 'info' | 'warning';
+    text: string;
+    learn_more_url: string;
+    dismissible: boolean;
+}
+interface TipsState {
+    seen?: string[];
+}
+export declare const TIPS: AgentGuardTip[];
+export declare function tipsStatePath(): string;
+export declare function readTipsState(filePath?: string): TipsState;
+export declare function writeTipsState(state: TipsState, filePath?: string): void;
+export declare function unseenTips(state?: TipsState): AgentGuardTip[];
+export declare function markTipsSeen(ids: string[], filePath?: string): void;
+export declare function maybeShowStartupTips(force?: boolean): void;
+export declare function runTips(argv: string[]): Promise<number>;
+export {};
+//# sourceMappingURL=tips.d.ts.map

package/dist/cli/tips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tips.d.ts","sourceRoot":"","sources":["../../src/cli/tips.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,SAAS;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,eAAO,MAAM,IAAI,EAAE,aAAa,EAyE/B,CAAC;AAEF,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,aAAa,CAAC,QAAQ,GAAE,MAAwB,GAAG,SAAS,CAO3E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,GAAE,MAAwB,GAAG,IAAI,CAIzF;AAED,wBAAgB,UAAU,CAAC,KAAK,GAAE,SAA2B,GAAG,aAAa,EAAE,CAG9E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,QAAQ,GAAE,MAAwB,GAAG,IAAI,CAGpF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,UAAQ,GAAG,IAAI,CASxD;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B7D"}

package/dist/cli/tips.js

@@ -0,0 +1,191 @@
+"use strict";
+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.TIPS = void 0;
+exports.tipsStatePath = tipsStatePath;
+exports.readTipsState = readTipsState;
+exports.writeTipsState = writeTipsState;
+exports.unseenTips = unseenTips;
+exports.markTipsSeen = markTipsSeen;
+exports.maybeShowStartupTips = maybeShowStartupTips;
+exports.runTips = runTips;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const index_1 = require("../index");
+const colors_1 = require("./colors");
+exports.TIPS = [
+    {
+        id: 'cheap-read-only',
+        surface: 'models',
+        severity: 'info',
+        text: "Use 'openai/gpt-4o-mini' for read-only tasks. It is far cheaper than gpt-5 with the same audit guarantees.",
+        learn_more_url: 'https://agentguard.run/docs/models',
+        dismissible: true,
+    },
+    {
+        id: 'openrouter-cfo',
+        surface: 'auth',
+        severity: 'info',
+        text: 'One OpenRouter key gives access to hundreds of models across many providers. Your CFO sees one invoice while AgentGuard enforces who uses what.',
+        learn_more_url: 'https://agentguard.run/docs/openrouter',
+        dismissible: true,
+    },
+    {
+        id: 'public-verify',
+        surface: 'verify',
+        severity: 'info',
+        text: 'Share https://agentguard.run/verify with your auditor. Paste any receipt and get browser-based cryptographic verification with no install.',
+        learn_more_url: 'https://agentguard.run/verify',
+        dismissible: true,
+    },
+    {
+        id: 'weekly-pricing',
+        surface: 'models',
+        severity: 'info',
+        text: "Run 'agentguard models --sync-pricing' weekly to keep cost math current with OpenRouter live prices.",
+        learn_more_url: 'https://agentguard.run/docs/pricing',
+        dismissible: true,
+    },
+    {
+        id: 'payment-attestation',
+        surface: 'wizard',
+        severity: 'warning',
+        text: "Capability tier 'payment_execute' should require a verified attestation. Do not accept caller-supplied claims for real money movement.",
+        learn_more_url: 'https://agentguard.run/docs/capabilities',
+        dismissible: true,
+    },
+    {
+        id: 'shadow-rollout',
+        surface: 'policy',
+        severity: 'info',
+        text: "Use mode 'shadow' for the first day of a rollout. You get signed decisions before enforcement changes traffic.",
+        learn_more_url: 'https://agentguard.run/docs/policies',
+        dismissible: true,
+    },
+    {
+        id: 'verify-chain',
+        surface: 'verify',
+        severity: 'info',
+        text: "Run 'agentguard verify <log.jsonl> <pubkey>' before sharing an audit packet. Whole-chain verification catches missing entries.",
+        learn_more_url: 'https://agentguard.run/docs/verify',
+        dismissible: true,
+    },
+    {
+        id: 'local-overrides',
+        surface: 'models',
+        severity: 'info',
+        text: 'Negotiated rates belong in ~/.agentguard/cost-overrides.json. Keep pricing math local with the rest of the policy state.',
+        learn_more_url: 'https://agentguard.run/docs/pricing',
+        dismissible: true,
+    },
+    {
+        id: 'bedrock-routing',
+        surface: 'bindings',
+        severity: 'info',
+        text: 'Use the native Bedrock binding when AWS procurement requires direct provider calls. AgentGuard still signs every local decision.',
+        learn_more_url: 'https://agentguard.run/docs/bedrock',
+        dismissible: true,
+    },
+];
+function tipsStatePath() {
+    return path.join((0, colors_1.agentguardHome)(), 'tips-seen.json');
+}
+function readTipsState(filePath = tipsStatePath()) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        return Array.isArray(parsed.seen) ? parsed : { seen: [] };
+    }
+    catch {
+        return { seen: [] };
+    }
+}
+function writeTipsState(state, filePath = tipsStatePath()) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify({ seen: [...new Set(state.seen ?? [])] }, null, 2) + '\n', { mode: 0o600 });
+    try {
+        fs.chmodSync(filePath, 0o600);
+    }
+    catch {
+        return;
+    }
+}
+function unseenTips(state = readTipsState()) {
+    const seen = new Set(state.seen ?? []);
+    return exports.TIPS.filter((tip) => !seen.has(tip.id));
+}
+function markTipsSeen(ids, filePath = tipsStatePath()) {
+    const state = readTipsState(filePath);
+    writeTipsState({ seen: [...new Set([...(state.seen ?? []), ...ids])] }, filePath);
+}
+function maybeShowStartupTips(force = false) {
+    const state = readTipsState();
+    const startupIds = ['startup-wizard', 'startup-verify'];
+    const seen = new Set(state.seen ?? []);
+    if (!force && startupIds.every((id) => seen.has(id)))
+        return;
+    console.log('');
+    console.log('  ' + (0, colors_1.green)("Tip: try 'agentguard wizard' to set up in 90 seconds."));
+    console.log('  ' + (0, colors_1.green)('Tip: share https://agentguard.run/verify with your auditor.'));
+    markTipsSeen(startupIds);
+}
+async function runTips(argv) {
+    if (argv.includes('--help') || argv.includes('-h')) {
+        console.log('agentguard tips [--reset] [--json]');
+        return 0;
+    }
+    if (argv.includes('--reset')) {
+        writeTipsState({ seen: [] });
+        console.log('AgentGuard tips reset.');
+        return 0;
+    }
+    if (argv.includes('--json')) {
+        console.log(JSON.stringify(exports.TIPS, null, 2));
+        return 0;
+    }
+    console.log('');
+    console.log('  ' + (0, colors_1.banner)(index_1.AGENTGUARD_SPEND_VERSION));
+    console.log('');
+    for (const tip of exports.TIPS) {
+        const label = tip.severity === 'warning' ? 'warning' : 'tip';
+        console.log(`  ${(0, colors_1.green)(label)}  ${tip.text}`);
+        console.log(`       ${(0, colors_1.dim)(tip.learn_more_url)}`);
+    }
+    console.log('');
+    console.log('  ' + (0, colors_1.statusBar)());
+    console.log('');
+    markTipsSeen(exports.TIPS.filter((tip) => tip.dismissible).map((tip) => tip.id));
+    return 0;
+}
+//# sourceMappingURL=tips.js.map

package/dist/cli/tips.js.map

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

package/dist/cli/wizard.d.ts

@@ -0,0 +1,27 @@
+export interface WizardAnswers {
+    building: string;
+    template: string;
+    capability: string;
+    allowedModels: string[];
+    fallbackModel: string;
+    perCallCents: number;
+    perDayCents: number;
+    perMonthCents: number;
+    systemInstructions: string;
+}
+export declare class WizardStateMachine {
+    step: number;
+    readonly totalSteps = 7;
+    next(answer: string): boolean;
+    back(): void;
+    validate(step: number, answer: string): boolean;
+}
+export declare function runWizard(argv: string[]): Promise<number>;
+export declare function defaultAnswers(templateSlug?: string): WizardAnswers;
+export declare function writeWizardOutputs(answers: WizardAnswers, home?: string): {
+    policyPath: string;
+    quickstartTsPath: string;
+    quickstartPyPath: string;
+    snippet: string;
+};
+//# sourceMappingURL=wizard.d.ts.map

package/dist/cli/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/cli/wizard.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,kBAAkB;IAC7B,IAAI,SAAK;IACT,QAAQ,CAAC,UAAU,KAAK;IAExB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAM7B,IAAI,IAAI,IAAI;IAIZ,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;CAShD;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuB/D;AAED,wBAAgB,cAAc,CAAC,YAAY,SAAgB,GAAG,aAAa,CAe1E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,SAAmB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAY/K"}