@jinion/core 0.5.0 → 0.5.1

package/dist/team/decisions.js

@@ -0,0 +1,166 @@
+import { randomUUID } from 'node:crypto';
+import { rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { ApiRefusal } from '../jinion-account/api.js';
+import { readJson, updateJson } from '../lib/json-file.js';
+import { jinionHome } from '../lib/paths.js';
+const EMPTY = { cursor: '0', decisions: {}, queue: [], aliases: {} };
+/**
+ * The project's decisions, as a copy under ~/.jinion that its sessions read without a network: never in the repository,
+ * kept up to date from api.jinion.co, and gone once the user loses access.
+ */
+export class DecisionStore {
+    projectId;
+    account;
+    changed;
+    file;
+    constructor(projectId, account, 
+    /** After every change to the copy, such as one a sync took in. */
+    changed = () => { }) {
+        this.projectId = projectId;
+        this.account = account;
+        this.changed = changed;
+        this.file = join(jinionHome(), 'team', projectId, 'decisions.json');
+    }
+    all() {
+        return Object.values(this.saved().decisions);
+    }
+    get(id) {
+        const saved = this.saved();
+        return saved.decisions[saved.aliases[id] ?? id];
+    }
+    /** Sends what waits, then takes in every change since the last sync. */
+    async sync() {
+        await this.flush();
+        for (let more = true; more;) {
+            const page = await this.account.decisionChanges(this.projectId, this.saved().cursor);
+            this.update((saved) => {
+                const decisions = { ...saved.decisions };
+                for (const change of page.changes) {
+                    if ('deleted' in change)
+                        delete decisions[change.id];
+                    else
+                        decisions[change.id] = change;
+                }
+                return { ...saved, decisions, cursor: page.cursor };
+            });
+            more = page.more;
+        }
+    }
+    /** Sent at once; while the API can't be reached, kept here under a local id and sent with the next sync. */
+    async record(draft) {
+        try {
+            const made = await this.account.recordDecision(this.projectId, draft);
+            this.update((saved) => ({ ...saved, decisions: { ...saved.decisions, [made.id]: made } }));
+            return made;
+        }
+        catch (error) {
+            if (!unreachable(error))
+                throw error;
+            const waiting = this.waiting(draft);
+            this.update((saved) => ({ ...saved, decisions: { ...saved.decisions, [waiting.id]: waiting }, queue: [...saved.queue, { kind: 'record', localId: waiting.id, draft }] }));
+            return waiting;
+        }
+    }
+    async delete(id) {
+        const saved = this.saved();
+        const known = saved.aliases[id] ?? id;
+        // Recorded and deleted while offline: the API never needs to hear of it.
+        if (saved.queue.some((write) => write.kind === 'record' && write.localId === known)) {
+            return this.update((current) => ({ ...current, decisions: without(current.decisions, known), queue: current.queue.filter((write) => write.kind !== 'record' || write.localId !== known) }));
+        }
+        this.update((current) => ({ ...current, decisions: without(current.decisions, known) }));
+        try {
+            await this.account.deleteDecision(this.projectId, known);
+        }
+        catch (error) {
+            if (!unreachable(error))
+                throw error;
+            this.update((current) => ({ ...current, queue: [...current.queue, { kind: 'delete', id: known }] }));
+        }
+    }
+    /** Its author's client telling which commit carries it; offline, it is anchored again at the next check. */
+    async anchor(id, shas, repository) {
+        try {
+            const anchored = await this.account.anchorDecision(this.projectId, id, shas, repository);
+            this.update((saved) => ({ ...saved, decisions: { ...saved.decisions, [anchored.id]: anchored } }));
+        }
+        catch (error) {
+            if (!unreachable(error))
+                throw error;
+        }
+    }
+    /** As the user lost access to the project, or signed out. */
+    purge() {
+        rmSync(join(this.file, '..'), { recursive: true, force: true });
+    }
+    /** The waiting writes in order, until the API can't be reached again; one it refuses for good is dropped. */
+    async flush() {
+        for (let write = this.saved().queue[0]; write; write = this.saved().queue[0]) {
+            try {
+                await this.send(write);
+            }
+            catch (error) {
+                if (unreachable(error))
+                    return;
+                const refused = write;
+                if (refused.kind === 'record')
+                    this.update((saved) => ({ ...saved, decisions: without(saved.decisions, refused.localId) }));
+            }
+            this.update((saved) => ({ ...saved, queue: saved.queue.slice(1) }));
+        }
+    }
+    async send(write) {
+        if (write.kind === 'delete')
+            return this.account.deleteDecision(this.projectId, write.id);
+        const made = await this.account.recordDecision(this.projectId, write.draft);
+        this.update((saved) => ({
+            ...saved,
+            decisions: { ...without(saved.decisions, write.localId), [made.id]: made },
+            aliases: { ...saved.aliases, [write.localId]: made.id },
+        }));
+    }
+    /** How a decision recorded offline shows until the API has it: its author's draft. */
+    waiting(draft) {
+        const user = this.account.user();
+        const now = new Date().toISOString();
+        return {
+            id: `local_${randomUUID()}`,
+            title: draft.title,
+            decision: draft.decision,
+            reason: draft.reason,
+            turnedDown: draft.turnedDown ?? null,
+            origin: draft.origin,
+            status: 'draft',
+            author: user && { id: user.id, name: user.name, email: user.email },
+            backend: draft.backend,
+            model: draft.model,
+            branch: draft.branch ?? null,
+            baseCommit: draft.baseCommit ?? null,
+            paths: draft.paths ?? [],
+            symbols: draft.symbols ?? [],
+            supersedes: draft.supersedes ?? null,
+            supersededBy: null,
+            anchors: [],
+            createdAt: now,
+            updatedAt: now,
+            version: '0',
+        };
+    }
+    saved() {
+        return readJson(this.file, EMPTY);
+    }
+    update(change) {
+        updateJson(this.file, EMPTY, change);
+        this.changed();
+    }
+}
+/** Offline, or api.jinion.co down; a refusal for what was sent is the caller's to hear. */
+function unreachable(error) {
+    return !(error instanceof ApiRefusal) || error.status >= 500;
+}
+function without(decisions, id) {
+    const { [id]: _, ...rest } = decisions;
+    return rest;
+}
+//# sourceMappingURL=decisions.js.map

package/dist/team/decisions.js.map

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

package/dist/team/history.d.ts

@@ -0,0 +1,27 @@
+/** Runs git in `folder` and answers with what it printed; rejects when git fails. */
+export type Git = (folder: string, args: string[]) => Promise<string>;
+export declare function runGit(folder: string, args: string[]): Promise<string>;
+/** Which commits a folder has: HEAD's, and those its branch's upstream has beyond them, as of the last fetch. */
+export interface Ancestry {
+    head: string;
+    /** Missing when HEAD is detached. */
+    branch?: string;
+    /** HEAD and every commit it descends from. */
+    inHead: ReadonlySet<string>;
+    upstreamOnly: ReadonlySet<string>;
+}
+/**
+ * Each folder's ancestry, read in two passes of git rather than one check per decision, and kept until git says
+ * something moved, so sorting the decisions again costs no git at all.
+ */
+export declare class History {
+    private readonly git;
+    private readonly read;
+    constructor(git?: Git);
+    /** Undefined outside git, or before a first commit. */
+    of(folder: string): Promise<Ancestry | undefined>;
+    /** As HEAD, a branch or a fetch moved. */
+    forget(): void;
+    private readAncestry;
+}
+//# sourceMappingURL=history.d.ts.map

package/dist/team/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/team/history.ts"],"names":[],"mappings":"AAKA,qFAAqF;AACrF,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEtE,wBAAsB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,mBAE1D;AAED,iHAAiH;AACjH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,qBAAa,OAAO;IAGN,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoD;IAEzE,YAA6B,GAAG,GAAE,GAAY,EAAI;IAElD,uDAAuD;IACvD,EAAE,CAAC,MAAM,EAAE,MAAM,iCAShB;IAED,0CAA0C;IAC1C,MAAM,SAEL;YAEa,YAAY;CAe3B"}

package/dist/team/history.js

@@ -0,0 +1,49 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const run = promisify(execFile);
+export async function runGit(folder, args) {
+    return (await run('git', args, { cwd: folder, timeout: 30_000, maxBuffer: 512 * 1024 * 1024 })).stdout;
+}
+/**
+ * Each folder's ancestry, read in two passes of git rather than one check per decision, and kept until git says
+ * something moved, so sorting the decisions again costs no git at all.
+ */
+export class History {
+    git;
+    read = new Map();
+    constructor(git = runGit) {
+        this.git = git;
+    }
+    /** Undefined outside git, or before a first commit. */
+    of(folder) {
+        let ancestry = this.read.get(folder);
+        if (!ancestry) {
+            ancestry = this.readAncestry(folder);
+            this.read.set(folder, ancestry);
+        }
+        return ancestry;
+    }
+    /** As HEAD, a branch or a fetch moved. */
+    forget() {
+        this.read.clear();
+    }
+    async readAncestry(folder) {
+        try {
+            const [head, branch, inHead, upstreamOnly] = await Promise.all([
+                this.git(folder, ['rev-parse', 'HEAD']),
+                this.git(folder, ['branch', '--show-current']),
+                this.git(folder, ['rev-list', 'HEAD']),
+                // A branch with no upstream has nothing waiting to be pulled.
+                this.git(folder, ['rev-list', '@{upstream}', '^HEAD']).catch(() => ''),
+            ]);
+            return { head: head.trim(), ...(branch.trim() && { branch: branch.trim() }), inHead: shas(inHead), upstreamOnly: shas(upstreamOnly) };
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+function shas(output) {
+    return new Set(output.split('\n').filter(Boolean));
+}
+//# sourceMappingURL=history.js.map

package/dist/team/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/team/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAKhC,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAc,EAAE,IAAc;IACzD,OAAO,CAAC,MAAM,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AACzG,CAAC;AAYD;;;GAGG;AACH,MAAM,OAAO,OAAO;IAGW,GAAG;IAFf,IAAI,GAAG,IAAI,GAAG,EAAyC,CAAC;IAEzE,YAA6B,GAAG,GAAQ,MAAM;mBAAjB,GAAG;IAAiB,CAAC;IAElD,uDAAuD;IACvD,EAAE,CAAC,MAAc;QACf,IAAI,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAErC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,0CAA0C;IAC1C,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,MAAc;QACvC,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC7D,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;gBACvC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;gBAC9C,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;gBACtC,8DAA8D;gBAC9D,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;aACvE,CAAC,CAAC;YAEH,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QACxI,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF;AAED,SAAS,IAAI,CAAC,MAAc;IAC1B,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/team/prompt.d.ts

@@ -0,0 +1,20 @@
+import type { Decision, DecisionState } from './decision.js';
+import type { DecisionRecorder } from './tools.js';
+/** A decision as a session sees it. */
+export type Shown = Decision & {
+    state: DecisionState;
+};
+/** More than this and the rest are found with `find_decisions`, so the index never crowds the context. */
+export declare const INDEX_LIMIT = 30;
+/** What, who, when and where, in a line. */
+export declare function decisionLine(decision: Shown): string;
+export declare function authorOf(decision: Decision): string;
+/** The decisions that bind the work, nearest to it first, as the agent reads them. */
+export declare function indexOf(decisions: Shown[]): string;
+/** Told only where the user is in the project's team, in every mode. */
+export declare function teamSection(recorder: DecisionRecorder): string;
+/** Beside the next prompt after the user answered a question or approved a plan, which may have settled a decision. */
+export declare const SETTLED = "In the last turn the user answered your question or approved your plan. If that settled a decision worth recording by the guidance on team decisions, record it with `origin: asked`; if it didn\u2019t, record nothing.";
+/** Beside the next prompt once the decisions that bind the work changed since the agent was told them, as after a pull. */
+export declare function indexChanged(index: string): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/team/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/team/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,uCAAuC;AACvC,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAExD,0GAA0G;AAC1G,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B,4CAA4C;AAC5C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,KAAK,UAI3C;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,UAE1C;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,UAMzC;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,gBAAgB,UAkBrD;AAED,uHAAuH;AACvH,eAAO,MAAM,OAAO,6NACmM,CAAC;AAExN,2HAA2H;AAC3H,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,UAEzC"}

package/dist/team/prompt.js

@@ -0,0 +1,44 @@
+/** More than this and the rest are found with `find_decisions`, so the index never crowds the context. */
+export const INDEX_LIMIT = 30;
+/** What, who, when and where, in a line. */
+export function decisionLine(decision) {
+    const by = decision.state === 'draft' ? 'yours, not in a commit yet' : `${authorOf(decision)}, ${decision.createdAt.slice(0, 10)}`;
+    return `- ${decision.id}: ${decision.title} (${by}${decision.branch ? `, on ${decision.branch}` : ''})`;
+}
+export function authorOf(decision) {
+    return decision.author?.name ?? decision.author?.email ?? 'A former teammate';
+}
+/** The decisions that bind the work, nearest to it first, as the agent reads them. */
+export function indexOf(decisions) {
+    if (decisions.length === 0)
+        return 'None yet.';
+    const more = decisions.length > INDEX_LIMIT ? [`- …and ${decisions.length - INDEX_LIMIT} more; \`find_decisions\` finds them.`] : [];
+    return [...decisions.slice(0, INDEX_LIMIT).map(decisionLine), ...more].join('\n');
+}
+/** Told only where the user is in the project's team, in every mode. */
+export function teamSection(recorder) {
+    return `# Team decisions
+This project belongs to a team on Jinion, whose agents record the decisions that matter. Those that bind your work are the team's, carried by commits the user has: follow them. When one shapes your work, say so in your reply, naming it and who made it ("Ayşe decided on Oct 3 that …; I kept to it"), and call \`kept_to_decision\` with its id.
+
+Decisions that bind this work, nearest to it first:
+${recorder.index()}
+
+- Before you choose between real alternatives, look for decisions on it with \`find_decisions\`: by the paths you change, a symbol or a few words. One it lists as not in the user's code yet is a teammate's on another branch: never follow it as a rule.
+- When the user asks for something a binding decision rules out, don't just do it: say which decision and why, and ask whether to keep it or replace it. Replacing it is recording a decision with \`record_decision\`, \`supersedes\` set to its id and \`origin: requested\`.
+- In a plan, name the decisions it keeps to.
+
+Record the decisions that matter with \`record_decision\`, without asking and without being asked. Each goes to the team, whose agents keep to it once a commit carries it, so a teammate's agent doesn't undo on purpose what was chosen on purpose. The user sees each one in the conversation and can delete it.
+
+- Record a choice between real alternatives that a teammate would otherwise undo or redo: an architecture or a data shape, a library picked or turned down, a convention set, a behavior the user asked for that the code can't explain, a trade-off accepted on purpose.
+- Don't record renames, obvious fixes, what the code already makes plain, or anything that matters to this conversation only.
+- Write it to hold without this conversation: what was decided, why, and what was turned down and why it lost.
+- When a decision above covers the same choice, pass its id as \`supersedes\` rather than recording a near copy.
+- Never put secrets, keys, customer data or personal data in a decision.`;
+}
+/** Beside the next prompt after the user answered a question or approved a plan, which may have settled a decision. */
+export const SETTLED = 'In the last turn the user answered your question or approved your plan. If that settled a decision worth recording by the guidance on team decisions, record it with `origin: asked`; if it didn’t, record nothing.';
+/** Beside the next prompt once the decisions that bind the work changed since the agent was told them, as after a pull. */
+export function indexChanged(index) {
+    return `The team's decisions that bind this work changed since you were told them. Now, nearest to the work first:\n${index}`;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/team/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/team/prompt.ts"],"names":[],"mappings":"AAMA,0GAA0G;AAC1G,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAE9B,4CAA4C;AAC5C,MAAM,UAAU,YAAY,CAAC,QAAe;IAC1C,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAEnI,OAAO,KAAK,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,KAAK,KAAK,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;AAC1G,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAkB;IACzC,OAAO,QAAQ,CAAC,MAAM,EAAE,IAAI,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,mBAAmB,CAAC;AAChF,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,OAAO,CAAC,SAAkB;IACxC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAE/C,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,UAAU,SAAS,CAAC,MAAM,GAAG,WAAW,uCAAuC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAErI,OAAO,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpF,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,WAAW,CAAC,QAA0B;IACpD,OAAO;;;;EAIP,QAAQ,CAAC,KAAK,EAAE;;;;;;;;;;;;yEAYuD,CAAC;AAC1E,CAAC;AAED,uHAAuH;AACvH,MAAM,CAAC,MAAM,OAAO,GAClB,qNAAqN,CAAC;AAExN,2HAA2H;AAC3H,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,+GAA+G,KAAK,EAAE,CAAC;AAChI,CAAC"}

package/dist/team/repository.d.ts

@@ -0,0 +1,12 @@
+export interface RepositoryIdentity {
+    remoteUrl: string;
+    rootCommit: string;
+}
+/** The branch `folder` is on, missing when HEAD is detached, and HEAD's commit; undefined outside git or before a first commit. */
+export declare function headOf(folder: string): Promise<{
+    branch?: string;
+    commit: string;
+} | undefined>;
+/** What tells the repository at `root` from any other: where it is pushed, and its first commit; undefined without either. */
+export declare function repositoryIdentity(root: string): Promise<RepositoryIdentity | undefined>;
+//# sourceMappingURL=repository.d.ts.map

package/dist/team/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/team/repository.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,mIAAmI;AACnI,wBAAsB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CAUrG;AAED,8HAA8H;AAC9H,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAgB9F"}

package/dist/team/repository.js

@@ -0,0 +1,32 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const run = promisify(execFile);
+/** The branch `folder` is on, missing when HEAD is detached, and HEAD's commit; undefined outside git or before a first commit. */
+export async function headOf(folder) {
+    const git = async (...args) => (await run('git', args, { cwd: folder, timeout: 5_000 })).stdout.trim();
+    try {
+        const [branch, commit] = await Promise.all([git('branch', '--show-current'), git('rev-parse', 'HEAD')]);
+        return { ...(branch && { branch }), commit };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** What tells the repository at `root` from any other: where it is pushed, and its first commit; undefined without either. */
+export async function repositoryIdentity(root) {
+    const git = async (...args) => (await run('git', args, { cwd: root, timeout: 5_000 })).stdout;
+    try {
+        const remotes = (await git('remote')).split('\n').filter(Boolean);
+        const remote = remotes.includes('origin') ? 'origin' : remotes[0];
+        if (!remote)
+            return undefined;
+        const remoteUrl = (await git('remote', 'get-url', remote)).trim();
+        // Histories merged in bring first commits of their own; the smallest is the same one in every clone.
+        const rootCommit = (await git('rev-list', '--max-parents=0', 'HEAD')).split('\n').filter(Boolean).sort()[0];
+        return rootCommit ? { remoteUrl, rootCommit } : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=repository.js.map

package/dist/team/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../src/team/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAOhC,mIAAmI;AACnI,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAc;IACzC,MAAM,GAAG,GAAG,KAAK,EAAE,GAAG,IAAc,EAAE,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAEjH,IAAI,CAAC;QACH,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,EAAE,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAExG,OAAO,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,8HAA8H;AAC9H,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,MAAM,GAAG,GAAG,KAAK,EAAE,GAAG,IAAc,EAAE,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAExG,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAE9B,MAAM,SAAS,GAAG,CAAC,MAAM,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClE,qGAAqG;QACrG,MAAM,UAAU,GAAG,CAAC,MAAM,GAAG,CAAC,UAAU,EAAE,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAE5G,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/team/secrets.d.ts

@@ -0,0 +1,3 @@
+/** What in `text` looks like a key or token, named; undefined when nothing does. */
+export declare function secretIn(text: string): string | undefined;
+//# sourceMappingURL=secrets.d.ts.map

package/dist/team/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../src/team/secrets.ts"],"names":[],"mappings":"AAcA,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,sBAEpC"}

package/dist/team/secrets.js

@@ -0,0 +1,18 @@
+/** Keys and tokens as the services that issue them write them, each with what to call it when one turns up. */
+const SECRETS = [
+    [/-----BEGIN [A-Z ]*PRIVATE KEY-----/, 'a private key'],
+    [/\bAKIA[0-9A-Z]{16}\b/, 'an AWS access key'],
+    [/\b(gh[pousr]_[A-Za-z0-9]{36,}|github_pat_[A-Za-z0-9_]{40,})\b/, 'a GitHub token'],
+    [/\bxox[abposr]-[A-Za-z0-9-]{10,}/, 'a Slack token'],
+    [/\b[sr]k_live_[A-Za-z0-9]{16,}/, 'a Stripe key'],
+    [/\bsk-(ant-)?[A-Za-z0-9_-]{20,}/, 'an API key'],
+    [/\bAIza[0-9A-Za-z_-]{35}\b/, 'a Google API key'],
+    [/\beyJ[A-Za-z0-9_-]{10,}\.eyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}/, 'a signed token'],
+    [/\b[a-z]+:\/\/[^\s:/@]+:[^\s@/]+@/i, 'a password in an address'],
+    [/\b(password|passwd|secret|api[_-]?key|access[_-]?token|private[_-]?key)\b["']?\s*[:=]\s*["']?[^\s"']{8,}/i, 'a secret'],
+];
+/** What in `text` looks like a key or token, named; undefined when nothing does. */
+export function secretIn(text) {
+    return SECRETS.find(([pattern]) => pattern.test(text))?.[1];
+}
+//# sourceMappingURL=secrets.js.map

package/dist/team/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../src/team/secrets.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,MAAM,OAAO,GAAuB;IAClC,CAAC,oCAAoC,EAAE,eAAe,CAAC;IACvD,CAAC,sBAAsB,EAAE,mBAAmB,CAAC;IAC7C,CAAC,+DAA+D,EAAE,gBAAgB,CAAC;IACnF,CAAC,iCAAiC,EAAE,eAAe,CAAC;IACpD,CAAC,+BAA+B,EAAE,cAAc,CAAC;IACjD,CAAC,gCAAgC,EAAE,YAAY,CAAC;IAChD,CAAC,2BAA2B,EAAE,kBAAkB,CAAC;IACjD,CAAC,oEAAoE,EAAE,gBAAgB,CAAC;IACxF,CAAC,mCAAmC,EAAE,0BAA0B,CAAC;IACjE,CAAC,2GAA2G,EAAE,UAAU,CAAC;CAC1H,CAAC;AAEF,oFAAoF;AACpF,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/team/tools.d.ts

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+import type { ToolCall } from '../agent/tools.js';
+import type { ReviewPoint } from '../map/review.js';
+/** What the agent says of a decision; the session fills in the rest itself. */
+declare const recording: {
+    title: z.ZodString;
+    decision: z.ZodString;
+    reason: z.ZodString;
+    turnedDown: z.ZodOptional<z.ZodString>;
+    origin: z.ZodEnum<{
+        agent: "agent";
+        asked: "asked";
+        requested: "requested";
+    }>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    supersedes: z.ZodOptional<z.ZodString>;
+};
+declare const finding: {
+    path: z.ZodOptional<z.ZodString>;
+    symbol: z.ZodOptional<z.ZodString>;
+    words: z.ZodOptional<z.ZodString>;
+};
+export type RecordedDecision = z.infer<z.ZodObject<typeof recording>>;
+export type DecisionQuery = z.infer<z.ZodObject<typeof finding>>;
+/** What a turn changed, held against the decisions: those it goes against, and teammates' on other branches it meets. */
+export interface DecisionReview {
+    points: ReviewPoint[];
+    /** Each a teammate's decision not in the user's code yet, told once a session. */
+    warnings: string[];
+}
+/** One conversation's part in its project's team decisions, as its session knows it: who, on what, where. */
+export interface DecisionRecorder {
+    /** Whether the user is in the project's team now, which the tools and the guidance are offered on. */
+    ready(): boolean;
+    /** The decisions that bind the conversation's work, nearest to it first; told the agent as it is read. */
+    index(): string;
+    /** The index again once it changed since the agent was told it, as after a pull; undefined while it didn't. */
+    indexChange(): string | undefined;
+    record(decision: RecordedDecision): Promise<string>;
+    find(query: DecisionQuery): string;
+    /** The agent kept to a decision, which the conversation shows. */
+    kept(id: string): string;
+    /** A turn that changed `paths`, from the conversation's folder. */
+    review(paths: string[]): Promise<DecisionReview>;
+}
+/** A tool the agent records and keeps to the team's decisions with; each backend offers it its own way. */
+export interface TeamTool<S extends z.ZodRawShape = z.ZodRawShape> {
+    description: string;
+    input: S;
+    run(input: z.infer<z.ZodObject<S>>): string | Promise<string>;
+}
+export declare function teamTools(recorder: DecisionRecorder): {
+    record_decision: TeamTool<{
+        title: z.ZodString;
+        decision: z.ZodString;
+        reason: z.ZodString;
+        turnedDown: z.ZodOptional<z.ZodString>;
+        origin: z.ZodEnum<{
+            agent: "agent";
+            asked: "asked";
+            requested: "requested";
+        }>;
+        paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        supersedes: z.ZodOptional<z.ZodString>;
+    }>;
+    find_decisions: TeamTool<{
+        path: z.ZodOptional<z.ZodString>;
+        symbol: z.ZodOptional<z.ZodString>;
+        words: z.ZodOptional<z.ZodString>;
+    }>;
+    kept_to_decision: TeamTool<{
+        id: z.ZodString;
+    }>;
+};
+export type TeamAction = keyof ReturnType<typeof teamTools>;
+/** `find_decisions` as the conversation shows it, worded alike whichever backend called it. */
+export declare function findDecisionsCall(input: unknown): ToolCall;
+export declare const TEAM_ACTIONS: Set<string>;
+/** Their calls show no row of their own: the decision's row says what was recorded or kept to. */
+export declare const QUIET_TEAM_ACTIONS: Set<string>;
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/team/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/team/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,+EAA+E;AAC/E,QAAA,MAAM,SAAS;IACb,KAAK;IACL,QAAQ;IACR,MAAM;IACN,UAAU;IACV,MAAM;;;;;IAGN,KAAK;IACL,UAAU;CACX,CAAC;AAEF,QAAA,MAAM,OAAO;IACX,IAAI;IACJ,MAAM;IACN,KAAK;CACN,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC;AAEtE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC;AAEjE,yHAAyH;AACzH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,6GAA6G;AAC7G,MAAM,WAAW,gBAAgB;IAC/B,sGAAsG;IACtG,KAAK,IAAI,OAAO,CAAC;IACjB,0GAA0G;IAC1G,KAAK,IAAI,MAAM,CAAC;IAChB,+GAA+G;IAC/G,WAAW,IAAI,MAAM,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC;IACnC,kEAAkE;IAClE,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,mEAAmE;IACnE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAClD;AAED,2GAA2G;AAC3G,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,CAAC;IACT,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/D;AAID,wBAAgB,SAAS,CAAC,QAAQ,EAAE,gBAAgB;IAEhD,eAAe;;;;;;;;;;;;;IAMf,cAAc;;;;;IAMd,gBAAgB;;;EAMnB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAE5D,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAI1D;AAED,eAAO,MAAM,YAAY,aAAoG,CAAC;AAE9H,kGAAkG;AAClG,eAAO,MAAM,kBAAkB,aAAkF,CAAC"}

package/dist/team/tools.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { DecisionOrigin } from './decision.js';
+/** What the agent says of a decision; the session fills in the rest itself. */
+const recording = {
+    title: z.string().max(200).describe('What was decided, in a few words.'),
+    decision: z.string().max(4000).describe('The decision itself, in a few sentences that hold without this conversation.'),
+    reason: z.string().max(4000).describe('Why, so a teammate who wasn’t here understands.'),
+    turnedDown: z.string().max(4000).optional().describe('The alternatives and why they lost.'),
+    origin: DecisionOrigin.describe('asked: the user answered your question or approved your plan. requested: the user asked for it. agent: your own call.'),
+    paths: z.array(z.string()).max(200).optional().describe('The files it concerns, from the repository’s root; the files this turn changed when left out.'),
+    supersedes: z.string().optional().describe('The id of a recorded decision this one replaces.'),
+};
+const finding = {
+    path: z.string().optional().describe('A file or a folder, from the repository’s root: the decisions on what is in it.'),
+    symbol: z.string().optional().describe('A function, type or component, by its name.'),
+    words: z.string().optional().describe('A few words of what it is about.'),
+};
+const define = (tool) => tool;
+export function teamTools(recorder) {
+    return {
+        record_decision: define({
+            description: 'Records a decision that matters to the project’s team, for the workspace’s members, whose agents keep to it once a commit carries it. Record it as you make it, without asking; the user sees it and can delete it.',
+            input: recording,
+            run: (decision) => recorder.record(decision),
+        }),
+        find_decisions: define({
+            description: 'Finds the team’s decisions that bind this work, in full: by a path, a symbol or a few words. Look before you choose between real alternatives, and follow what it finds.',
+            input: finding,
+            run: (query) => recorder.find(query),
+        }),
+        kept_to_decision: define({
+            description: 'Says you kept to a binding decision this turn, by its id, which the user then sees. Call it once per decision, as you name it in your reply.',
+            input: { id: z.string().describe('The decision’s id, as `dec_…`.') },
+            run: ({ id }) => recorder.kept(id),
+        }),
+    };
+}
+/** `find_decisions` as the conversation shows it, worded alike whichever backend called it. */
+export function findDecisionsCall(input) {
+    const { path, symbol, words } = (input ?? {});
+    return { name: 'other', input: { title: 'Look for team decisions', detail: [path, symbol, words].filter(Boolean).join(' · ') } };
+}
+export const TEAM_ACTIONS = new Set(['record_decision', 'find_decisions', 'kept_to_decision']);
+/** Their calls show no row of their own: the decision's row says what was recorded or kept to. */
+export const QUIET_TEAM_ACTIONS = new Set(['record_decision', 'kept_to_decision']);
+//# sourceMappingURL=tools.js.map

package/dist/team/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/team/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,+EAA+E;AAC/E,MAAM,SAAS,GAAG;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IACxE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,8EAA8E,CAAC;IACvH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACxF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC3F,MAAM,EAAE,cAAc,CAAC,QAAQ,CAC7B,uHAAuH,CACxH;IACD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+FAA+F,CAAC;IACxJ,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CAC/F,CAAC;AAEF,MAAM,OAAO,GAAG;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iFAAiF,CAAC;IACvH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACrF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CAC1E,CAAC;AAoCF,MAAM,MAAM,GAAG,CAA0B,IAAiB,EAAE,EAAE,CAAC,IAAI,CAAC;AAEpE,MAAM,UAAU,SAAS,CAAC,QAA0B;IAClD,OAAO;QACL,eAAe,EAAE,MAAM,CAAC;YACtB,WAAW,EACT,qNAAqN;YACvN,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC;SAC7C,CAAC;QACF,cAAc,EAAE,MAAM,CAAC;YACrB,WAAW,EACT,0KAA0K;YAC5K,KAAK,EAAE,OAAO;YACd,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;SACrC,CAAC;QACF,gBAAgB,EAAE,MAAM,CAAC;YACvB,WAAW,EAAE,8IAA8I;YAC3J,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC,EAAE;YACpE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;SACnC,CAAC;KACH,CAAC;AACJ,CAAC;AAID,+FAA+F;AAC/F,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAkB,CAAC;IAE/D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;AACnI,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAS,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,CAAwB,CAAC,CAAC;AAE9H,kGAAkG;AAClG,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAS,CAAC,iBAAiB,EAAE,kBAAkB,CAAwB,CAAC,CAAC"}