@owlmeans/viable-sdk 0.1.18-rc.8 → 0.1.18

package/build/tools/git/types.d.ts

@@ -0,0 +1,25 @@
+import type { ConnectGitCommit, ConnectGitState, ConnectGitSyncResult, ConnectGithubBranchList, ConnectGithubConnection, ConnectGithubRepoList } from '@owlmeans/viable-common';
+/** How the git and GitHub tools put the platform's answers into words. */
+export interface GitToolHelper {
+    /** The connection in one line: who connected it, where it publishes, and whether it still works. */
+    renderConnection: (connection: ConnectGithubConnection | null) => string;
+    /**
+     * The whole git state: the GitHub connection, then the working tree — or why it cannot be read now
+     * (the preview is not ready) — and what to do next.
+     */
+    renderState: (state: ConnectGitState) => string;
+    /** The latest commits, newest first, each with the hash a revert names. */
+    renderHistory: (commits: ConnectGitCommit[]) => string;
+    /** What a push or a pull did, and what to do about a refusal. */
+    renderSync: (direction: string, result: ConnectGitSyncResult) => string;
+    /** One page of repositories, with how to reach the next. */
+    renderRepos: (list: ConnectGithubRepoList, search?: string) => string;
+    /** One page of one repository's branches. */
+    renderBranches: (fullName: string, list: ConnectGithubBranchList) => string;
+    /**
+     * The address the user opens to connect GitHub, with what happens there and after it — the
+     * authorization ends in their browser, never in a tool.
+     */
+    renderAuthorize: (authorizeUrl: string) => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/tools/git/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/git/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAAE,eAAe,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,uBAAuB,EACzG,qBAAqB,EACtB,MAAM,yBAAyB,CAAA;AAEhC,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,oGAAoG;IACpG,gBAAgB,EAAE,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,KAAK,MAAM,CAAA;IACxE;;;OAGG;IACH,WAAW,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,MAAM,CAAA;IAC/C,2EAA2E;IAC3E,aAAa,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,MAAM,CAAA;IACtD,iEAAiE;IACjE,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,KAAK,MAAM,CAAA;IACvE,4DAA4D;IAC5D,WAAW,EAAE,CAAC,IAAI,EAAE,qBAAqB,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IACrE,6CAA6C;IAC7C,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,KAAK,MAAM,CAAA;IAC3E;;;OAGG;IACH,eAAe,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAA;CAClD"}

package/build/tools/git/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/tools/git/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/git/types.ts"],"names":[],"mappings":""}

package/build/tools/git.d.ts

@@ -0,0 +1,4 @@
+import type { GitToolHelper } from './git/types.js';
+export declare const createGitToolHelper: () => GitToolHelper;
+export declare const gitToolHelper: GitToolHelper;
+//# sourceMappingURL=git.d.ts.map

package/build/tools/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/tools/git.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,eAAO,MAAM,mBAAmB,QAAO,aA4FtC,CAAA;AAED,eAAO,MAAM,aAAa,eAAwB,CAAA"}

package/build/tools/git.js

@@ -0,0 +1,83 @@
+import { GIT_FILES_SHOWN, GIT_SYNC_WORDS, GITHUB_STATUS_WORDS } from './consts.local.js';
+export const createGitToolHelper = () => {
+    const day = (iso) => iso.slice(0, 10);
+    const commitLine = (commit) => `${commit.shortHash} ${commit.subject} — ${commit.authorName}, ${day(commit.committedAt)}`;
+    const renderConnection = (connection) => connection == null
+        ? 'GitHub: not connected — connect_github gives the user the address to authorize it'
+        : `GitHub: ${connection.githubLogin}${connection.repoFullName != null ? ` → ${connection.repoFullName}` : ''}`
+            + ` · ${GITHUB_STATUS_WORDS[connection.status] ?? connection.status}`;
+    const renderState = ({ connection, git }) => {
+        const lines = [renderConnection(connection)];
+        if (git == null) {
+            lines.push('working tree: not readable now — git lives in the preview, which is not ready.'
+                + ' preview_control { action: start } starts it; then call git_status again.');
+            return lines.join('\n');
+        }
+        if (!git.initialized) {
+            lines.push('working tree: no repository yet — the first commit creates it.');
+            return lines.join('\n');
+        }
+        lines.push(`branch ${git.branch}${git.head != null ? ` · head ${commitLine(git.head)}` : ' · no commits yet'}`);
+        if (git.ahead != null || git.behind != null) {
+            lines.push(`against GitHub: ${git.ahead ?? 0} ahead, ${git.behind ?? 0} behind`);
+        }
+        if (git.dirty) {
+            lines.push(`${git.changedFiles} uncommitted change(s):`);
+            lines.push(...git.files.slice(0, GIT_FILES_SHOWN).map(file => `  ${file.status} ${file.path}`));
+            if (git.changedFiles > Math.min(git.files.length, GIT_FILES_SHOWN)) {
+                lines.push(`  … and ${git.changedFiles - Math.min(git.files.length, GIT_FILES_SHOWN)} more`);
+            }
+            lines.push('next: git_commit { message } keeps them; git_discard throws them away (confirm: true).');
+        }
+        else {
+            lines.push('working tree: clean');
+        }
+        return lines.join('\n');
+    };
+    const renderHistory = commits => commits.length < 1
+        ? 'No commits yet.'
+        : [
+            `${commits.length} latest commit(s), newest first:`,
+            ...commits.map(commit => `- ${commitLine(commit)}`),
+            'next: git_revert { hash, confirm: true } brings one commit\'s tree back as a new commit.',
+        ].join('\n');
+    const renderSync = (direction, result) => {
+        const words = GIT_SYNC_WORDS[result.status] ?? result.status;
+        const position = result.ahead != null || result.behind != null
+            ? ` (${result.ahead ?? 0} ahead, ${result.behind ?? 0} behind)`
+            : '';
+        return `${direction}: ${words}${position}.`
+            + (result.message != null && result.message !== '' && result.status !== 'ok' && result.status !== 'up-to-date'
+                ? `\ngit said: ${result.message}`
+                : '')
+            + (direction === 'pull' && result.status === 'ok' ? '\nThe preview was rebuilt from the pulled tree.' : '');
+    };
+    const renderRepos = (list, search) => list.repos.length < 1
+        ? `No repositories on page ${list.page}${search != null ? ` matching "${search}"` : ''}.`
+            + (list.hasMore ? ` More on page ${list.page + 1}.` : '')
+        : [
+            `page ${list.page}${search != null ? ` (matching "${search}" on this page)` : ''}:`,
+            ...list.repos.map(repo => `- ${repo.fullName}${repo.private ? ' (private)' : ''} · default branch`
+                + ` ${repo.defaultBranch}${repo.archived ? ' · archived' : ''}${repo.fork ? ' · fork' : ''}`
+                + `${repo.language != null ? ` · ${repo.language}` : ''}`),
+            ...(list.hasMore ? [`More on page ${list.page + 1}.`] : []),
+            'next: github_repositories { owner, repo } lists a repository\'s branches.',
+        ].join('\n');
+    const renderBranches = (fullName, list) => list.branches.length < 1
+        ? `${fullName} has no branches on page ${list.page}.`
+        : [
+            `${fullName}, page ${list.page}:`,
+            ...list.branches.map(branch => `- ${branch.name}${branch.protected ? ' (protected)' : ''}`),
+            ...(list.hasMore ? [`More on page ${list.page + 1}.`] : []),
+        ].join('\n');
+    const renderAuthorize = authorizeUrl => [
+        'Ask the user to open this address in the browser where they are signed in to OwlMeans:',
+        authorizeUrl,
+        'GitHub asks them to authorize access to their repositories; it then returns to the OwlMeans web'
+            + ' application, which finishes connecting this project. The address works once, for ten minutes.',
+        'next: once they say it is done, git_status shows the connection.',
+    ].join('\n');
+    return { renderConnection, renderState, renderHistory, renderSync, renderRepos, renderBranches, renderAuthorize };
+};
+export const gitToolHelper = createGitToolHelper();
+//# sourceMappingURL=git.js.map

package/build/tools/git.js.map

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

package/build/tools/handover/types.d.ts

@@ -0,0 +1,49 @@
+import type { ModelTask } from '@owlmeans/viable-common';
+import type { SessionRuntime } from '../../types.js';
+import type { InflightCall } from '../inflight/types.js';
+import type { McpToolAnswer, ToolDefinition, ToolResult } from '../types.js';
+/** What the task loop found once it had done its own work. */
+export interface HandoverCollection {
+    /** Detached calls that settled — each reported here and nowhere else. */
+    settled: InflightCall[];
+    /** The next model task, taken; `null` when none was queued. */
+    task: ModelTask | null;
+    /** Calls still running on the platform that no tool waits on. */
+    running: InflightCall[];
+}
+/**
+ * The delegated mode's tool calls: a platform call that stops for a model call its own parent must
+ * perform is answered with that TASK, and its result is delivered by the task loop afterwards.
+ *
+ * Bound to the tool deps, whose `inflight` registry outlives every session the connector reopens.
+ */
+export interface HandoverHelper {
+    /**
+     * Answer one tool call: its result when the call finishes first, the model task it is blocked on
+     * when one arrives first, or "still running" at `HANDOVER_WAIT_MS`. The call itself is never
+     * abandoned — an identical repeat joins it, and its result is reported by the task loop.
+     */
+    run: (tool: ToolDefinition, args: Record<string, unknown>) => Promise<McpToolAnswer>;
+    /**
+     * A tool's result as the MCP wire carries it; a throw becomes a phrased `isError` answer, logged,
+     * and pushed through `notify` when only a person can resolve it. Never rejects.
+     */
+    contain: (tool: string, run: () => Promise<ToolResult>) => Promise<McpToolAnswer>;
+    /**
+     * Wait up to `waitMs` for a detached call to settle or a model task to arrive, then take both
+     * what settled and the next queued task.
+     */
+    collect: (session: SessionRuntime, waitMs: number) => Promise<HandoverCollection>;
+    /**
+     * The collection as a tool result led by `lead`; `null` when it holds nothing at all, so the
+     * caller answers in its own words. Every settled call is in `structured.settled[]`, a refused one
+     * marked `isError` there and never on the result itself.
+     */
+    report: (collected: HandoverCollection, lead?: string) => ToolResult | null;
+    /**
+     * Whether a call no tool waits on is running or settled-and-unreported — what makes the task loop
+     * wait for one.
+     */
+    pending: () => boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/tools/handover/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/handover/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE5E,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,+DAA+D;IAC/D,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IACtB,iEAAiE;IACjE,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,GAAG,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,aAAa,CAAC,CAAA;IACpF;;;OAGG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,aAAa,CAAC,CAAA;IACjF;;;OAGG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACjF;;;;OAIG;IACH,MAAM,EAAE,CAAC,SAAS,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,CAAA;IAC3E;;;OAGG;IACH,OAAO,EAAE,MAAM,OAAO,CAAA;CACvB"}

package/build/tools/handover/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/tools/handover/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/handover/types.ts"],"names":[],"mappings":""}

package/build/tools/handover.d.ts

@@ -0,0 +1,8 @@
+import type { HandoverHelper } from './handover/types.js';
+import type { ToolDeps } from './types.js';
+/**
+ * @param deps The tool deps; their `inflight` registry is the one every handover of this server
+ *   shares. A deps bag without one (a test calling a tool directly) gets a private, empty one.
+ */
+export declare const makeHandoverHelper: (deps: ToolDeps) => HandoverHelper;
+//# sourceMappingURL=handover.d.ts.map

package/build/tools/handover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handover.d.ts","sourceRoot":"","sources":["../../src/tools/handover.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAsB,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC7E,OAAO,KAAK,EAAiC,QAAQ,EAAc,MAAM,YAAY,CAAA;AAerF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,SAAU,QAAQ,KAAG,cAuInD,CAAA"}

package/build/tools/handover.js

@@ -0,0 +1,138 @@
+import { HANDOVER_WAIT_MS } from '../consts.js';
+import { makeTaskEnvelopeModel } from '../task/envelope.js';
+import { HANDOVER_SLICE_MS, STATUS_TOOL_OF } from './consts.local.js';
+import { createInflightCalls } from './inflight.js';
+import { refusalHelper } from './refusal.js';
+const textOf = (answer) => answer.content.map(part => part.text).join('\n');
+const namesOf = (calls) => [...new Set(calls.map(call => call.tool))].join(', ');
+/** A wait that ends at `ms` or when `signal` aborts, whichever comes first. */
+const pause = async (ms, signal) => await new Promise(resolve => {
+    const timer = setTimeout(resolve, ms);
+    signal.addEventListener('abort', () => {
+        clearTimeout(timer);
+        resolve();
+    }, { once: true });
+});
+/**
+ * @param deps The tool deps; their `inflight` registry is the one every handover of this server
+ *   shares. A deps bag without one (a test calling a tool directly) gets a private, empty one.
+ */
+export const makeHandoverHelper = (deps) => {
+    const inflight = deps.inflight ?? createInflightCalls();
+    const answerOf = (result) => ({
+        content: [{ type: 'text', text: result.text }],
+        ...(result.structured != null ? { structuredContent: result.structured } : {}),
+        ...(result.isError === true ? { isError: true } : {}),
+    });
+    const contain = async (tool, run) => {
+        try {
+            return answerOf(await run());
+        }
+        catch (e) {
+            // The balance, the spend consent and a conversion's confirmation are refusals only a
+            // PERSON resolves: phrased from their packed fields (never the raw marker) and pushed out
+            // of band as well, where the host has a channel for it.
+            const person = refusalHelper.personRefusalPhrase(e);
+            const text = person ?? refusalHelper.refusalPhrase(e);
+            deps.log(`${tool} failed: ${refusalHelper.refusalMessage(e)}`);
+            if (person != null) {
+                deps.notify?.('warning', text);
+            }
+            return { content: [{ type: 'text', text }], isError: true };
+        }
+    };
+    const envelopeOf = (task) => makeTaskEnvelopeModel(task).renderTaskEnvelope({ harness: deps.host.harness });
+    const statusToolOf = (tool) => STATUS_TOOL_OF[tool] ?? 'project_status';
+    const run = async (tool, args) => {
+        const call = inflight.join(tool.name, args, async () => await contain(tool.name, async () => await tool.run(args, deps)));
+        const deadline = Date.now() + HANDOVER_WAIT_MS;
+        // In slices: the session to watch may not exist yet, or may be replaced while the call runs —
+        // a delegated create opens its unattached session from inside the very call waited on here.
+        while (Date.now() < deadline) {
+            const session = deps.currentSession();
+            const stop = new AbortController();
+            const slice = Math.min(HANDOVER_SLICE_MS, deadline - Date.now());
+            const outcome = await Promise.race([
+                call.done.then(() => 'done'),
+                session != null
+                    ? session.taskAvailable(slice, stop.signal).then(ready => ready ? 'task' : 'tick')
+                    : pause(slice, stop.signal).then(() => 'tick'),
+            ]);
+            stop.abort();
+            if (outcome === 'done') {
+                inflight.forget(call);
+                return call.answer;
+            }
+            if (outcome === 'task' && session != null) {
+                const task = await session.nextTask(0);
+                // Another caller was quicker — the race goes on.
+                if (task == null)
+                    continue;
+                inflight.release(call);
+                return answerOf({
+                    text: `${tool.name} is NOT finished — the platform is waiting on a model call you must`
+                        + ` perform. Do not call ${tool.name} again. Run the task below in a clean subagent at LOW`
+                        + ' reasoning effort, then call submit_task_result {taskId, result}; its reply is'
+                        + ` ${tool.name}'s result, or the next model call it waits on.\n\n`
+                        + envelopeOf(task),
+                    structured: { taskId: task.id, waitingOn: tool.name },
+                });
+            }
+        }
+        inflight.release(call);
+        return answerOf({
+            text: `${tool.name} is still running on the platform — call next_task (or read`
+                + ` ${statusToolOf(tool.name)}). Calling ${tool.name} again with the same arguments waits on`
+                + ' the same call rather than starting another.',
+            structured: { running: tool.name },
+        });
+    };
+    const collect = async (session, waitMs) => {
+        const stop = new AbortController();
+        await Promise.race([
+            inflight.settled(waitMs, stop.signal),
+            session.taskAvailable(waitMs, stop.signal),
+        ]);
+        stop.abort();
+        return {
+            settled: inflight.drainSettled(),
+            task: await session.nextTask(0),
+            running: inflight.running(),
+        };
+    };
+    const report = (collected, lead) => {
+        const { settled, task, running } = collected;
+        if (settled.length < 1 && task == null && running.length < 1)
+            return null;
+        const parts = lead != null ? [lead] : [];
+        for (const call of settled) {
+            const answer = call.answer;
+            parts.push(`--- ${call.tool} ${answer.isError === true ? 'was refused' : 'finished'} ---\n${textOf(answer)}`);
+        }
+        if (task != null) {
+            parts.push((running.length > 0
+                ? `The next model call to perform (${namesOf(running)} still running on the platform):`
+                : 'The next model call to perform:')
+                + `\n\n${envelopeOf(task)}`);
+        }
+        else if (running.length > 0) {
+            parts.push(`${namesOf(running)} still running on the platform — call next_task (or read`
+                + ` ${statusToolOf(running[0].tool)}).`);
+        }
+        return {
+            text: parts.join('\n\n'),
+            structured: {
+                settled: settled.map(call => ({
+                    tool: call.tool,
+                    text: textOf(call.answer),
+                    ...(call.answer.isError === true ? { isError: true } : {}),
+                })),
+                ...(task != null ? { taskId: task.id } : {}),
+                ...(running.length > 0 ? { running: running.map(call => call.tool) } : {}),
+            },
+        };
+    };
+    const pending = () => inflight.running().length > 0 || inflight.hasSettled();
+    return { run, contain, collect, report, pending };
+};
+//# sourceMappingURL=handover.js.map

package/build/tools/handover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handover.js","sourceRoot":"","sources":["../../src/tools/handover.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAK5C,MAAM,MAAM,GAAG,CAAC,MAAqB,EAAU,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAElG,MAAM,OAAO,GAAG,CAAC,KAAqB,EAAU,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAExG,+EAA+E;AAC/E,MAAM,KAAK,GAAG,KAAK,EAAE,EAAU,EAAE,MAAmB,EAAiB,EAAE,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;IAClG,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IACrC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;QACpC,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,OAAO,EAAE,CAAA;IACX,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;AACpB,CAAC,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAc,EAAkB,EAAE;IACnE,MAAM,QAAQ,GAAkB,IAAI,CAAC,QAAQ,IAAI,mBAAmB,EAAE,CAAA;IAEtE,MAAM,QAAQ,GAAG,CAAC,MAAkB,EAAiB,EAAE,CAAC,CAAC;QACvD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACvD,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,CAAA;IAEF,MAAM,OAAO,GAAG,KAAK,EAAE,IAAY,EAAE,GAA8B,EAA0B,EAAE;QAC7F,IAAI,CAAC;YACH,OAAO,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;QAC9B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,qFAAqF;YACrF,0FAA0F;YAC1F,wDAAwD;YACxD,MAAM,MAAM,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAA;YACnD,MAAM,IAAI,GAAG,MAAM,IAAI,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;YACrD,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,YAAY,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;YAC9D,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;gBACnB,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;YAChC,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QACtE,CAAC;IACH,CAAC,CAAA;IAED,MAAM,UAAU,GAAG,CAAC,IAAe,EAAU,EAAE,CAC7C,qBAAqB,CAAC,IAAI,CAAC,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;IAEhF,MAAM,YAAY,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAA;IAEvF,MAAM,GAAG,GAAG,KAAK,EAAE,IAAoB,EAAE,IAA6B,EAA0B,EAAE;QAChG,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;QACzH,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,gBAAgB,CAAA;QAE9C,8FAA8F;QAC9F,4FAA4F;QAC5F,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;YACrC,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAA;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;YAChE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBACjC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAe,CAAC;gBACrC,OAAO,IAAI,IAAI;oBACb,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,MAAe,CAAC,CAAC,CAAC,MAAe,CAAC;oBACpG,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAe,CAAC;aAC1D,CAAC,CAAA;YACF,IAAI,CAAC,KAAK,EAAE,CAAA;YAEZ,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;gBACvB,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBAErB,OAAO,IAAI,CAAC,MAAO,CAAA;YACrB,CAAC;YACD,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;gBAC1C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;gBACtC,iDAAiD;gBACjD,IAAI,IAAI,IAAI,IAAI;oBAAE,SAAQ;gBAC1B,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;gBAEtB,OAAO,QAAQ,CAAC;oBACd,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,qEAAqE;0BACnF,yBAAyB,IAAI,CAAC,IAAI,uDAAuD;0BACzF,gFAAgF;0BAChF,IAAI,IAAI,CAAC,IAAI,oDAAoD;0BACjE,UAAU,CAAC,IAAI,CAAC;oBACpB,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE;iBACtD,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAEtB,OAAO,QAAQ,CAAC;YACd,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,6DAA6D;kBAC3E,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,yCAAyC;kBAC3F,8CAA8C;YAClD,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;SACnC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,KAAK,EAAE,OAAuB,EAAE,MAAc,EAA+B,EAAE;QAC7F,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAA;QAClC,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;YACrC,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;SAC3C,CAAC,CAAA;QACF,IAAI,CAAC,KAAK,EAAE,CAAA;QAEZ,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,YAAY,EAAE;YAChC,IAAI,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE;SAC5B,CAAA;IACH,CAAC,CAAA;IAED,MAAM,MAAM,GAAG,CAAC,SAA6B,EAAE,IAAa,EAAqB,EAAE;QACjF,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,SAAS,CAAA;QAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QAEzE,MAAM,KAAK,GAAa,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAClD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAO,CAAA;YAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAC/G,CAAC;QACD,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CACR,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;gBACjB,CAAC,CAAC,mCAAmC,OAAO,CAAC,OAAO,CAAC,kCAAkC;gBACvF,CAAC,CAAC,iCAAiC,CAAC;kBACpC,OAAO,UAAU,CAAC,IAAI,CAAC,EAAE,CAC5B,CAAA;QACH,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,0DAA0D;kBACpF,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7C,CAAC;QAED,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;YACxB,UAAU,EAAE;gBACV,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAO,CAAC;oBAC1B,GAAG,CAAC,IAAI,CAAC,MAAO,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC5D,CAAC,CAAC;gBACH,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5C,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3E;SACF,CAAA;IACH,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,GAAY,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAA;IAErF,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AACnD,CAAC,CAAA"}

package/build/tools/host/types.d.ts

@@ -0,0 +1,34 @@
+import type { ToolHost } from '../types.js';
+/**
+ * What a tool host can do — the predicates a catalogue entry's `availability` names, and the
+ * wording decisions that depend on the same facts.
+ */
+export interface ToolHostHelper {
+    anyHost: () => boolean;
+    localTarget: (host: ToolHost) => boolean;
+    cloudTarget: (host: ToolHost) => boolean;
+    withExecutor: (host: ToolHost) => boolean;
+    delegatedLlm: (host: ToolHost) => boolean;
+    /**
+     * Whether this host can hold a connector SESSION across calls.
+     *
+     * A session is a connector ATTACHED: a process that stays, drains the project's operations and
+     * keeps the model tasks handed to it until the parent agent answers them. The stdio server is
+     * exactly that. The URL-configured host answers one request and forgets — opening a session there
+     * would claim the project's single connector slot, supersede the connector legitimately holding
+     * it, and be abandoned before the first operation was delivered.
+     */
+    sessionCapable: (host: ToolHost) => boolean;
+    /**
+     * Whether this session performs the platform's model calls — every one of them: project drafting,
+     * content checks, story formatting, every run's calls and a conversion's.
+     *
+     * That is the delegated mode and nothing else, and it needs two things at once — the delegated
+     * llm, and a connector able to drain the tasks it produces. A host that cannot hold a session can
+     * never do the draining, whatever the llm says. In the cloud mode the platform performs all of
+     * them, so the task loop (`next_task` / `submit_task_result`) is offered on exactly this predicate,
+     * and so is the handover a blocked tool answers with.
+     */
+    performsModelTasks: (host: ToolHost) => boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/tools/host/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/host/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,OAAO,CAAA;IACtB,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAA;IACxC,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAA;IACxC,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAA;IACzC,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAA;IACzC;;;;;;;;OAQG;IACH,cAAc,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAA;IAC3C;;;;;;;;;OASG;IACH,kBAAkB,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAA;CAChD"}

package/build/tools/host/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/tools/host/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/host/types.ts"],"names":[],"mappings":""}

package/build/tools/host.d.ts

@@ -0,0 +1,4 @@
+import type { ToolHostHelper } from './host/types.js';
+export declare const createToolHostHelper: () => ToolHostHelper;
+export declare const toolHostHelper: ToolHostHelper;
+//# sourceMappingURL=host.d.ts.map

package/build/tools/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/tools/host.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,eAAO,MAAM,oBAAoB,QAAO,cAiBvC,CAAA;AAED,eAAO,MAAM,cAAc,gBAAyB,CAAA"}

package/build/tools/host.js

@@ -0,0 +1,13 @@
+import { ToolHostKind } from './consts.js';
+export const createToolHostHelper = () => {
+    const anyHost = () => true;
+    const localTarget = (host) => host.target === 'local';
+    const cloudTarget = (host) => host.target === 'cloud';
+    const withExecutor = (host) => host.hasExecutor;
+    const delegatedLlm = (host) => host.llm === 'local';
+    const sessionCapable = (host) => host.kind === ToolHostKind.Stdio;
+    const performsModelTasks = (host) => delegatedLlm(host) && sessionCapable(host);
+    return { anyHost, localTarget, cloudTarget, withExecutor, delegatedLlm, sessionCapable, performsModelTasks };
+};
+export const toolHostHelper = createToolHostHelper();
+//# sourceMappingURL=host.js.map

package/build/tools/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/tools/host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAmB,EAAE;IACvD,MAAM,OAAO,GAAG,GAAY,EAAE,CAAC,IAAI,CAAA;IAEnC,MAAM,WAAW,GAAG,CAAC,IAAc,EAAW,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,CAAA;IAExE,MAAM,WAAW,GAAG,CAAC,IAAc,EAAW,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,CAAA;IAExE,MAAM,YAAY,GAAG,CAAC,IAAc,EAAW,EAAE,CAAC,IAAI,CAAC,WAAW,CAAA;IAElE,MAAM,YAAY,GAAG,CAAC,IAAc,EAAW,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,OAAO,CAAA;IAEtE,MAAM,cAAc,GAAG,CAAC,IAAc,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,KAAK,CAAA;IAEpF,MAAM,kBAAkB,GAAG,CAAC,IAAc,EAAW,EAAE,CACrD,YAAY,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,CAAA;IAE5C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAA;AAC9G,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,EAAE,CAAA"}

package/build/tools/iam/types.d.ts

@@ -0,0 +1,44 @@
+import type { IamAssignGrant, IamGrant, IamGrantsResponse, IamGroup, IamGroupsResponse, IamMember, IamMembersResponse, IamOrganization, IamOrganizationsResponse, IamPermissionDefinition, IamPermissionsResponse, IamRevokeGrant, IamUser, IamUsersResponse } from '@owlmeans/viable-common';
+/**
+ * How the generated app's sign-in tools check what they were asked and put the platform's answers
+ * into words.
+ */
+export interface IamToolHelper {
+    /**
+     * What a tool's action still lacks, said as the refusal — or `null` when it may call. Checked
+     * BEFORE any call, so a half-formed write never reaches the platform: an invite without an e-mail,
+     * an update that changes nothing, a grant naming no subject or two, an assign with a revoke-only
+     * mode (`all`, `inherit`), a group without its organization, a removal or a deletion the user has
+     * not agreed to (`confirm: true`).
+     */
+    missing: (tool: string, args: Record<string, unknown>) => string | null;
+    /**
+     * The grant body `manage_app_grant` sends, from its flat input: a person (`profileId`, with
+     * `entitySlug` binding an entity-scoped grant to that organization) or a group (`group` key, its
+     * organization's `entitySlug`) — never both. Call {@link missing} first.
+     */
+    grantBody: (args: Record<string, unknown>) => IamAssignGrant;
+    renderUsers: (response: IamUsersResponse, lead: string) => string;
+    renderUser: (user: IamUser) => string;
+    renderPermissions: (response: IamPermissionsResponse) => string;
+    renderDefinition: (definition: IamPermissionDefinition) => string;
+    /**
+     * The grant rows, counted as held and restricted: a `restricted: true` entry is an inherited grant
+     * the subject's own restriction withholds — listed, never held.
+     */
+    renderGrants: (response: IamGrantsResponse) => string;
+    /** One grant: subject, records, mode, binding, origin (`bundle` in a group's own listing), `restricted`. */
+    renderGrant: (grant: IamGrant) => string;
+    /**
+     * What a revoke did, by its mode: `inherit` took back the subject's own value; a records revoke
+     * removed those ids; any other one revoked the permission and restricted a declared one.
+     */
+    renderRevoke: (body: IamRevokeGrant) => string;
+    renderOrganizations: (response: IamOrganizationsResponse) => string;
+    renderOrganization: (organization: IamOrganization) => string;
+    renderMembers: (response: IamMembersResponse, lead: string) => string;
+    renderMember: (member: IamMember) => string;
+    renderGroups: (response: IamGroupsResponse, entitySlug: string) => string;
+    renderGroup: (group: IamGroup) => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/tools/iam/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/iam/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAE,kBAAkB,EACvG,eAAe,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,cAAc,EAAE,OAAO,EACnH,gBAAgB,EACjB,MAAM,yBAAyB,CAAA;AAEhC;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,IAAI,CAAA;IACvE;;;;OAIG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,cAAc,CAAA;IAC5D,WAAW,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACjE,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAA;IACrC,iBAAiB,EAAE,CAAC,QAAQ,EAAE,sBAAsB,KAAK,MAAM,CAAA;IAC/D,gBAAgB,EAAE,CAAC,UAAU,EAAE,uBAAuB,KAAK,MAAM,CAAA;IACjE;;;OAGG;IACH,YAAY,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,MAAM,CAAA;IACrD,4GAA4G;IAC5G,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,MAAM,CAAA;IACxC;;;OAGG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,MAAM,CAAA;IAC9C,mBAAmB,EAAE,CAAC,QAAQ,EAAE,wBAAwB,KAAK,MAAM,CAAA;IACnE,kBAAkB,EAAE,CAAC,YAAY,EAAE,eAAe,KAAK,MAAM,CAAA;IAC7D,aAAa,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACrE,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,CAAA;IAC3C,YAAY,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,CAAA;IACzE,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,MAAM,CAAA;CACzC"}

package/build/tools/iam/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/tools/iam/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/iam/types.ts"],"names":[],"mappings":""}

package/build/tools/iam.d.ts

@@ -0,0 +1,4 @@
+import type { IamToolHelper } from './iam/types.js';
+export declare const createIamToolHelper: () => IamToolHelper;
+export declare const iamToolHelper: IamToolHelper;
+//# sourceMappingURL=iam.d.ts.map

package/build/tools/iam.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iam.d.ts","sourceRoot":"","sources":["../../src/tools/iam.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,eAAO,MAAM,mBAAmB,QAAO,aA0PtC,CAAA;AAED,eAAO,MAAM,aAAa,eAAwB,CAAA"}