@voxslopuli/openagentsy 0.0.0-stage → 0.2.0

package/dist/commands/lessons.js

@@ -0,0 +1,97 @@
+import { decideLesson, LESSON_ACTIONS, listLessons, pendingLessons, readEvalResult, } from '@openagentsy/hooks';
+import { deciderBy } from '../who.js';
+export { deciderBy };
+/**
+ * The inbox.
+ */
+export async function runLessons(stateRoot) {
+    const all = await listLessons(stateRoot);
+    const pending = pendingLessons(all);
+    return {
+        root: stateRoot,
+        lessons: pending.map((lesson) => ({
+            id: lesson.id,
+            state: lesson.state,
+            summary: lesson.summary,
+            occurrences: lesson.occurrences,
+            kind: lesson.kind,
+            sessions: lesson.sessions.length,
+            updated_at: lesson.updated_at,
+        })),
+        awaiting: pending.length,
+        total: all.length,
+    };
+}
+/**
+ * The inbox, as it is read.
+ */
+export function formatLessonsReport(report) {
+    const lines = [];
+    lines.push(`Lessons (${report.awaiting} awaiting a decision, ${report.total} in all)`);
+    if (report.lessons.length === 0) {
+        lines.push('  none');
+        return `${lines.join('\n')}\n`;
+    }
+    for (const lesson of report.lessons) {
+        const count = `${lesson.occurrences}x`.padStart(4);
+        lines.push(`  ${lesson.id.padEnd(22)}${lesson.state.padEnd(14)}${count}  ${lesson.summary}`);
+    }
+    return `${lines.join('\n')}\n`;
+}
+/**
+ * Record a decision.
+ */
+export async function runLessonDecision(stateRoot, id, action, options = {}) {
+    if (!LESSON_ACTIONS.includes(action)) {
+        return {
+            ok: false,
+            id,
+            state: '',
+            reason: `unknown lesson action: ${action}`,
+            hint: `an action is one of ${LESSON_ACTIONS.join(', ')}`,
+        };
+    }
+    let evalResult = options.evalResult;
+    if (evalResult === undefined && options.evalResultPath !== undefined) {
+        const read = await readEvalResult(stateRoot, options.evalResultPath);
+        if (read.error !== undefined) {
+            return {
+                ok: false,
+                id,
+                state: '',
+                reason: `the proof result could not be read: ${read.error}`,
+                hint: 'the result file has to be there, and it has to be the JSON the runner wrote',
+            };
+        }
+        evalResult = read.result;
+    }
+    const outcome = await decideLesson(stateRoot, {
+        id,
+        action: action,
+        decidedBy: deciderBy(options.decidedBy),
+        reason: options.reason ?? `decided by the person running the command: ${action}`,
+        ...(evalResult === undefined ? {} : { evalResult }),
+        ...(options.changeRef === undefined ? {} : { changeRef: options.changeRef }),
+        ...(options.outcome === undefined ? {} : { outcome: options.outcome }),
+    });
+    if (!outcome.ok) {
+        return { ok: false, id, state: '', reason: outcome.reason, hint: outcome.hint };
+    }
+    return {
+        ok: true,
+        id: outcome.lesson.id,
+        state: outcome.lesson.state,
+        reason: options.reason ?? `decided by the person running the command: ${action}`,
+    };
+}
+/**
+ * The decision, as it is read.
+ */
+export function formatLessonDecision(report) {
+    if (report.ok) {
+        return `${report.id} is now ${report.state}\n`;
+    }
+    const hint = report.hint === undefined ? '' : `\nNext: ${report.hint}`;
+    return `${report.reason}${hint}\n`;
+}
+//# sourceMappingURL=lessons.js.map

package/dist/commands/lessons.js.map

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

package/dist/commands/lessons.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lessons.test.d.ts.map

package/dist/commands/lessons.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lessons.test.d.ts","sourceRoot":"","sources":["../../src/commands/lessons.test.ts"],"names":[],"mappings":""}

package/dist/commands/lessons.test.js

@@ -0,0 +1,146 @@
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { captureCandidate } from '@openagentsy/hooks';
+import { describe, expect, it } from 'vitest';
+import { deciderBy, formatLessonDecision, formatLessonsReport, runLessonDecision, runLessons, } from './lessons.js';
+async function stateRoot() {
+    const root = await mkdtemp(join(tmpdir(), 'openagentsy-cli-lessons-'));
+    return { root, remove: () => rm(root, { recursive: true, force: true }) };
+}
+/** A candidate waiting for a decision. */
+async function candidate(root, summary, session) {
+    const outcome = await captureCandidate(root, {
+        summary,
+        observations: [{ kind: 'missing-file', detail: 'the file was missing', session }],
+        explicitCorrection: true,
+    });
+    if (!outcome.ok)
+        throw new Error('the candidate was not created');
+    return outcome.lesson;
+}
+describe('the lessons inbox', () => {
+    it('lists the lessons that are waiting for a person', async () => {
+        const { root, remove } = await stateRoot();
+        try {
+            await candidate(root, 'the agent wrote to a file that does not exist', 'session-1');
+            const report = await runLessons(root);
+            expect(report.awaiting).toBe(1);
+            expect(report.lessons[0]?.summary).toBe('the agent wrote to a file that does not exist');
+            expect(report.lessons[0]?.occurrences).toBe(1);
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('sorts the inbox by occurrences and then by recency', async () => {
+        const { root, remove } = await stateRoot();
+        try {
+            await candidate(root, 'the first lesson', 'session-1');
+            await candidate(root, 'the second lesson', 'session-2');
+            await captureCandidate(root, {
+                summary: 'the first lesson',
+                observations: [{ kind: 'missing-file', detail: 'the file was missing', session: 's' }],
+                explicitCorrection: true,
+            });
+            const report = await runLessons(root);
+            expect(report.lessons[0]?.summary).toBe('the first lesson');
+            expect(report.lessons[0]?.occurrences).toBe(2);
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('says when there is nothing to decide', async () => {
+        const { root, remove } = await stateRoot();
+        try {
+            const report = await runLessons(root);
+            expect(report.awaiting).toBe(0);
+            expect(formatLessonsReport(report)).toContain('none');
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('reads the inbox as a table', async () => {
+        const { root, remove } = await stateRoot();
+        try {
+            await candidate(root, 'the agent wrote to a file that does not exist', 'session-1');
+            const text = formatLessonsReport(await runLessons(root));
+            expect(text).toContain('1 awaiting a decision');
+            expect(text).toContain('the agent wrote to a file that does not exist');
+        }
+        finally {
+            await remove();
+        }
+    });
+});
+describe('the lesson decision', () => {
+    it('records the decision and names the person', async () => {
+        const { root, remove } = await stateRoot();
+        try {
+            const lesson = await candidate(root, 'the first lesson', 'session-1');
+            const report = await runLessonDecision(root, lesson.id, 'reject', {
+                decidedBy: 'the person',
+                reason: 'it is not what we want',
+            });
+            expect(report.ok).toBe(true);
+            expect(report.state).toBe('rejected');
+            expect(formatLessonDecision(report)).toContain('is now rejected');
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('decides for a person when nobody says who', async () => {
+        const { root, remove } = await stateRoot();
+        try {
+            const lesson = await candidate(root, 'the first lesson', 'session-1');
+            const report = await runLessonDecision(root, lesson.id, 'reject');
+            expect(report.ok).toBe(true);
+            expect(deciderBy()).toBe('human');
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('refuses an action that is not one of the four', async () => {
+        const { root, remove } = await stateRoot();
+        try {
+            const lesson = await candidate(root, 'the first lesson', 'session-1');
+            const report = await runLessonDecision(root, lesson.id, 'obliterate');
+            expect(report.ok).toBe(false);
+            expect(report.reason).toMatch(/unknown lesson action/);
+            expect(formatLessonDecision(report)).toContain('Next:');
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('says so when the lesson is not there', async () => {
+        const { root, remove } = await stateRoot();
+        try {
+            const report = await runLessonDecision(root, 'oa-lesson-nosuch0', 'reject');
+            expect(report.ok).toBe(false);
+            expect(report.reason).toMatch(/not there/);
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('says so when the proof result cannot be read', async () => {
+        const { root, remove } = await stateRoot();
+        try {
+            const lesson = await candidate(root, 'the first lesson', 'session-1');
+            const report = await runLessonDecision(root, lesson.id, 'validate', {
+                evalResultPath: join(root, 'not-there.json'),
+            });
+            expect(report.ok).toBe(false);
+            expect(report.reason).toMatch(/could not be read/);
+        }
+        finally {
+            await remove();
+        }
+    });
+});
+//# sourceMappingURL=lessons.test.js.map

package/dist/commands/lessons.test.js.map

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

package/dist/commands/models.d.ts

@@ -0,0 +1,49 @@
+import { type FetchLike, type ModelLock, type ProviderId } from '@openagentsy/models';
+export type ModelsMode = 'init' | 'refresh' | 'switch';
+export type ModelsOptions = {
+    /** The workspace: the roles file lives here. */
+    workspace: string;
+    /** The state root: the lock file and the model cache live here. */
+    stateRoot: string;
+    mode: ModelsMode;
+    providers: string[];
+    /** Take the flash variant of the family a role would get, when it qualifies. */
+    preferFlash?: boolean;
+    allowTraining?: boolean;
+    allowRetention?: boolean;
+    yes?: boolean;
+    key?: string;
+    fetchImpl?: FetchLike;
+};
+export type ModelsResult = {
+    lock: ModelLock;
+    reasons: Record<string, string>;
+    rejected: Record<string, {
+        openCodeId: string;
+        reason: string;
+    }[]>;
+    failures: Record<string, string>;
+    written: boolean;
+    path: string;
+    changes: {
+        role: string;
+        from?: string;
+        to: string;
+        note: string;
+    }[];
+    mode: ModelsMode;
+    providers: ProviderId[];
+    /** What a switch touches besides the lock. */
+    touches?: SwitchTouches;
+};
+/** What a switch touches besides the lock file. */
+export type SwitchTouches = {
+    /** The command that regenerates the agent files. */
+    rebuild: string;
+    /** The providers the lock names now. */
+    providers: ProviderId[];
+    /** The environment variables the providers read their key from. */
+    keys: string[];
+};
+export declare function runModels(options: ModelsOptions): Promise<ModelsResult>;
+//# sourceMappingURL=models.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/commands/models.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,SAAS,EACd,KAAK,UAAU,EAQhB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG;IAC1B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IACnE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrE,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB,CAAC;AAEF,mDAAmD;AACnD,MAAM,MAAM,aAAa,GAAG;IAC1B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,mEAAmE;IACnE,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAoFF,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAsD7E"}

package/dist/commands/models.js

@@ -0,0 +1,125 @@
+import { join } from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { loadRoles } from '@openagentsy/core';
+import { LOCK_FILE_NAME, providerAliasSummary, providerIdsFromLock, readLock, resolveProviderAlias, selectModels, writeLock, } from '@openagentsy/models';
+/** The provider a command runs with when nothing else is asked for. */
+const DEFAULT_PROVIDERS = ['opencode-go'];
+/** The environment variable each provider reads its key from. */
+const PROVIDER_KEYS = {
+    opencode: 'OPENCODE_API_KEY',
+    'opencode-go': 'OPENCODE_API_KEY',
+    'ollama-cloud': 'OLLAMA_API_KEY',
+    ollama: undefined,
+};
+/** The provider names a person may type, resolved to the provider ids. */
+function parseProviders(input) {
+    const seen = new Set();
+    const selections = [];
+    for (const raw of input) {
+        for (const part of raw.split(',')) {
+            const name = part.trim().toLowerCase();
+            if (name.length === 0)
+                continue;
+            const provider = resolveProviderAlias(name);
+            if (!provider) {
+                throw new Error(`unknown provider "${name}". The names you may use: ${providerAliasSummary()}.`);
+            }
+            if (seen.has(provider))
+                continue;
+            seen.add(provider);
+            selections.push({ provider });
+        }
+    }
+    return selections;
+}
+/**
+ * The providers a command runs with.
+ *
+ * A refresh uses the providers the lock records, so a refresh cannot move
+ * the project back to a provider the lock no longer names. A lock that names
+ * no provider yet falls back to the default.
+ */
+function resolveProviders(mode, requested, previous) {
+    const parsed = parseProviders(requested);
+    if (parsed.length > 0)
+        return parsed;
+    if (mode === 'switch') {
+        throw new Error('switch needs a provider: openagentsy models switch ollama-cloud');
+    }
+    if (mode === 'refresh') {
+        const fromLock = providerIdsFromLock(previous);
+        if (fromLock.length > 0)
+            return fromLock.map((provider) => ({ provider }));
+    }
+    return parseProviders(DEFAULT_PROVIDERS);
+}
+async function confirm(question, yes) {
+    if (yes === true)
+        return true;
+    if (!process.stdin.isTTY)
+        return false;
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const answer = await rl.question(`${question} [y/N] `);
+        return answer.trim().toLowerCase() === 'y';
+    }
+    finally {
+        rl.close();
+    }
+}
+/** What the switch touches besides the lock. */
+function touchesFor(providers) {
+    const keys = [];
+    for (const provider of providers) {
+        const key = PROVIDER_KEYS[provider];
+        if (key !== undefined && !keys.includes(key))
+            keys.push(key);
+    }
+    return { rebuild: 'openagentsy build', providers, keys };
+}
+export async function runModels(options) {
+    const path = join(options.stateRoot, LOCK_FILE_NAME);
+    const roles = await loadRoles(join(options.workspace, 'roles.yaml'));
+    const previous = await readLock(path);
+    const providers = resolveProviders(options.mode, options.providers, previous);
+    const result = await selectModels({
+        root: options.stateRoot,
+        roles,
+        providers,
+        ...(options.preferFlash !== undefined ? { preferFlash: options.preferFlash } : {}),
+        ...(options.allowTraining !== undefined ? { allowTraining: options.allowTraining } : {}),
+        ...(options.allowRetention !== undefined ? { allowRetention: options.allowRetention } : {}),
+        ...(options.key !== undefined ? { benchLmKey: options.key } : {}),
+        ...(options.fetchImpl !== undefined ? { fetchImpl: options.fetchImpl } : {}),
+    });
+    const changes = [];
+    for (const [role, entry] of Object.entries(result.lock.roles)) {
+        const from = previous?.roles[role]?.model;
+        changes.push({
+            role,
+            ...(from !== undefined ? { from } : {}),
+            to: entry.model,
+            note: result.reasons[role] ?? '',
+        });
+    }
+    const approved = Object.keys(result.failures).length === 0
+        ? await confirm(`Write ${LOCK_FILE_NAME} with these ${changes.length} role assignments?`, options.yes)
+        : false;
+    if (approved) {
+        await writeLock(path, result.lock);
+    }
+    const providerIds = providers.map((selection) => selection.provider);
+    return {
+        lock: result.lock,
+        reasons: result.reasons,
+        rejected: result.rejected,
+        failures: result.failures,
+        written: approved,
+        path,
+        changes,
+        mode: options.mode,
+        providers: providerIds,
+        ...(options.mode === 'switch' ? { touches: touchesFor(providerIds) } : {}),
+    };
+}
+//# sourceMappingURL=models.js.map

package/dist/commands/models.js.map

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

package/dist/commands/report.d.ts

@@ -0,0 +1,57 @@
+import { type ProjectRoots, type ReportFacts } from '@openagentsy/core';
+/**
+ * `oa report --ethical`: what the run cost, and what it was worth (§12).
+ *
+ * The report is a rendering of facts that were read from the ledger, the
+ * board, the stores and the conformance report. It writes nothing, it
+ * reaches no network, and it judges nobody: it says what happened.
+ *
+ * The `--check` flag makes the report a gate. The rule it applies is the
+ * quality package's own: a ship verdict with an open floor finding is a
+ * fabricated pass, and the gate refuses it. So the command asks the gate
+ * whether a ship of this work would be accepted, and the answer is the
+ * exit code.
+ */
+/** The options the command takes. */
+export type ReportOptions = {
+    /** The session, and the subagents that rolled up into it. */
+    session?: string | undefined;
+    /** The bean: the rows whose task is that bean. */
+    bean?: string | undefined;
+    /** The window, as a phrase: 30d, 30 days ago, 2 weeks ago. */
+    since?: string | undefined;
+    /** Whether the report is a gate. */
+    check?: boolean | undefined;
+};
+/** The report, and what the command returns. */
+export type EthicalReport = {
+    /** The facts the report is rendered from. */
+    facts: ReportFacts;
+    /** The exit code the command returns. */
+    exitCode: number;
+    /** Why the gate refused, when it refused. */
+    refusal?: string | undefined;
+    /** The problem with the flags, when there is one. */
+    problem?: string | undefined;
+};
+/**
+ * The report.
+ *
+ * The scope names the rows the ledger is read for, the board records the
+ * oversight counts, and the findings store the gate. Nothing is written.
+ */
+export declare function runEthicalReport(roots: ProjectRoots, options?: ReportOptions): Promise<EthicalReport>;
+/**
+ * The report, as plain text.
+ *
+ * The text carries no colour, and a refusal is said in words rather than in
+ * an exit code alone, so a reader of the output knows what happened.
+ */
+export declare function formatEthicalReport(report: EthicalReport): string;
+/**
+ * The report, as JSON.
+ *
+ * The same facts the text is rendered from, so the two can never disagree.
+ */
+export declare function ethicalReportAsJson(report: EthicalReport): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/commands/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/commands/report.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,WAAW,EAEjB,MAAM,mBAAmB,CAAC;AAO3B;;;;;;;;;;;;GAYG;AAEH,qCAAqC;AACrC,MAAM,MAAM,aAAa,GAAG;IAC1B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG;IAC1B,6CAA6C;IAC7C,KAAK,EAAE,WAAW,CAAC;IACnB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,CAAC;AAgGF;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAwCxB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAKjE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAEjE"}