@sema-agent/server 1.185.0

package/dist/capabilities/repo-tools.js

@@ -0,0 +1,98 @@
+import { Type } from "typebox";
+export function parseRepo(input) {
+    const s = input.trim().replace(/\.git$/, "");
+    const m = /^[a-z]+:\/\/[^/]+\/(.+)$/i.exec(s);
+    const path = (m ? m[1] : s).replace(/^\/+|\/+$/g, "");
+    const parts = path.split("/").filter(Boolean);
+    if (parts.length < 2)
+        throw new Error(`cannot parse repo from "${input}" (expected owner/name or a URL)`);
+    return { owner: parts[parts.length - 2], repo: parts[parts.length - 1] };
+}
+const MAX_FILE_BYTES = 96 * 1024;
+const MAX_TREE_ENTRIES = 2000;
+const REQUEST_TIMEOUT_MS = 15_000;
+export class GiteaClient {
+    baseUrl;
+    token;
+    fetchImpl;
+    constructor(baseUrl, token, fetchImpl = fetch) {
+        this.baseUrl = baseUrl;
+        this.token = token;
+        this.fetchImpl = fetchImpl;
+    }
+    async api(path, accept = "application/json") {
+        const headers = { accept };
+        if (this.token)
+            headers.authorization = `token ${this.token}`;
+        const res = await this.fetchImpl(`${this.baseUrl}/api/v1${path}`, {
+            headers,
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        if (!res.ok)
+            throw new Error(`git api ${path} → HTTP ${res.status}`);
+        return res;
+    }
+    async defaultBranch({ owner, repo }) {
+        const info = (await (await this.api(`/repos/${owner}/${repo}`)).json());
+        return info.default_branch || "main";
+    }
+    async tree(coords, ref) {
+        const { owner, repo } = coords;
+        const body = (await (await this.api(`/repos/${owner}/${repo}/git/trees/${encodeURIComponent(ref)}?recursive=true&per_page=${MAX_TREE_ENTRIES}`)).json());
+        return (body.tree ?? []).filter((e) => e.type === "blob").map((e) => e.path);
+    }
+    async readFile(coords, path, ref) {
+        const { owner, repo } = coords;
+        const segments = path.split("/").filter(Boolean);
+        if (segments.some((s) => s === "..")) {
+            throw new Error(`invalid path "${path}" (".." segments are not allowed)`);
+        }
+        const body = (await (await this.api(`/repos/${owner}/${repo}/contents/${segments.map(encodeURIComponent).join("/")}?ref=${encodeURIComponent(ref)}`)).json());
+        if (body.type !== "file" || body.content == null)
+            throw new Error(`not a file: ${path}`);
+        const text = body.encoding === "base64" ? Buffer.from(body.content, "base64").toString("utf8") : body.content;
+        return text.length > MAX_FILE_BYTES
+            ? text.slice(0, MAX_FILE_BYTES) + `\n…[truncated, ${text.length - MAX_FILE_BYTES} more bytes]`
+            : text;
+    }
+    async pullDiff(coords, index) {
+        const { owner, repo } = coords;
+        const res = await this.api(`/repos/${owner}/${repo}/pulls/${index}.diff`, "text/plain");
+        const text = await res.text();
+        return text.length > MAX_FILE_BYTES * 4 ? text.slice(0, MAX_FILE_BYTES * 4) + "\n…[diff truncated]" : text;
+    }
+}
+export function repoToolsFor(client, coords) {
+    const ref = (r) => (r ? Promise.resolve(r) : client.defaultBranch(coords));
+    return [
+        {
+            name: "repo_tree",
+            description: "List file paths in the repository (recursive). Use this first to understand structure, then read specific files.",
+            effect: "read",
+            parameters: Type.Object({ ref: Type.Optional(Type.String({ description: "branch/tag/sha; default = repo default branch" })) }),
+            execute: async (args) => {
+                const a = args;
+                const paths = await client.tree(coords, await ref(a.ref));
+                return paths.join("\n");
+            },
+        },
+        {
+            name: "repo_read_file",
+            description: "Read one file's text from the repository. Read only the files you need (just-in-time).",
+            effect: "read",
+            parameters: Type.Object({ path: Type.String(), ref: Type.Optional(Type.String()) }),
+            execute: async (args) => {
+                const a = args;
+                return client.readFile(coords, a.path, await ref(a.ref));
+            },
+        },
+        {
+            name: "repo_pull_diff",
+            description: "Get the unified diff of a pull request by its number (for reviewing a PR's changes).",
+            effect: "read",
+            parameters: Type.Object({ index: Type.Integer({ description: "the PR number" }) }),
+            execute: async (args) => client.pullDiff(coords, Number(args.index)),
+        },
+    ];
+}
+//# sourceMappingURL=repo-tools.js.map

package/dist/capabilities/repo-tools.js.map

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

package/dist/capabilities/scenarios.d.ts

@@ -0,0 +1,72 @@
+import { type PromptProvider, type Runner, type SkillSpec, type ToolSpec, type WebSearchConfig } from "@sema-agent/core";
+import type { Metrics } from "../observability/metrics.js";
+import type { Logger } from "../observability/logger.js";
+import { GiteaClient } from "./repo-tools.js";
+import { type LoadedSkill } from "./skills.js";
+export interface ScenarioRequest {
+    scenario?: string;
+    repo?: string;
+    [k: string]: unknown;
+}
+export interface ScenarioBundle {
+    tools: ToolSpec[];
+    skills: SkillSpec[];
+    promptProvider?: PromptProvider;
+}
+export type Scenario = (req: ScenarioRequest, principal?: string) => ScenarioBundle;
+export interface ScenarioDeps {
+    runner: Runner;
+    subRunner: Runner;
+    model: string;
+    skills: LoadedSkill[];
+    repoClient?: GiteaClient;
+    requirePrincipal?: boolean;
+    webSearch?: WebSearchConfig;
+    metrics?: Metrics;
+    logger?: Logger;
+    oaApiBaseUrl?: string;
+    oaServiceToken?: string;
+    oaIssue?: {
+        baseUrl: string;
+        owner: string;
+        repo: string;
+        token: string;
+        defaultLabels?: number[];
+    };
+    brandIdentity?: boolean;
+}
+export { SEMA_IDENTITY } from "./prompts/identity.js";
+export declare function semaIdentityProvider(): PromptProvider;
+export declare function buildScenarios(deps: ScenarioDeps): Record<string, Scenario>;
+export declare function selectScenario(scenarios: Record<string, Scenario>, name: string | undefined): Scenario;
+export interface ScenarioDetail {
+    name: string;
+    source: "builtin" | "center";
+    builtin: boolean;
+    summary: string;
+    toolset: string;
+    tools: string[];
+    promptSummary: string;
+    enabled: boolean;
+}
+export declare function builtinScenarioDetails(scenarios: Record<string, Scenario>, deps: Pick<ScenarioDeps, "brandIdentity">): Record<string, ScenarioDetail>;
+export declare function centerScenarioDetails(specs: CenterScenarioSpec[] | undefined, builtinNames: string[]): Record<string, ScenarioDetail>;
+export interface CenterScenarioSpec {
+    name: string;
+    toolset: string;
+    prompt?: string;
+    enabled?: boolean;
+}
+export declare const SCENARIO_NAME_RE: RegExp;
+export declare const SCENARIO_PROMPT_MAX = 4096;
+export declare function centerScenarios(deps: ScenarioDeps, specs: CenterScenarioSpec[] | undefined, builtinNames: string[], logger?: Logger): {
+    overlay: Record<string, Scenario>;
+    shadows: string[];
+};
+export declare function mergeUserSkills(scenarioSkills: SkillSpec[] | undefined, userSkills: SkillSpec[] | undefined, logger?: Logger): SkillSpec[] | undefined;
+export interface ScenarioRuling {
+    scenario: string | null;
+    allowlist: string[];
+}
+export declare function gateScenarioRequest(ruling: ScenarioRuling | undefined, bodyScenario: unknown, defaultScenario: string): string;
+//# sourceMappingURL=scenarios.d.ts.map

package/dist/capabilities/scenarios.d.ts.map

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

package/dist/capabilities/scenarios.js

@@ -0,0 +1,241 @@
+import { DEFAULT_SYSTEM_PROMPT, assembleFullBodyTools, createGiteaIssueTool, defaultTaskRegistry } from "@sema-agent/core";
+import { HttpError } from "../security.js";
+import { nowTool } from "./builtin-tools.js";
+import { GiteaClient, parseRepo, repoToolsFor } from "./repo-tools.js";
+import { createCouncilTool, clampRounds } from "./code-review-council.js";
+import { stablePrompt } from "./prompt.js";
+import { createTeamTool, teamCoordinatorPrompt, getTeam, teamNames } from "./team.js";
+import { oaTools, oaPrompt } from "./oa-tools.js";
+import { createWebSearchBackend, webSearchConfigFromSettings } from "../plugins/web-search.js";
+import { skillsForScenario } from "./skills.js";
+export { SEMA_IDENTITY } from "./prompts/identity.js";
+import { SEMA_IDENTITY } from "./prompts/identity.js";
+export function semaIdentityProvider() {
+    return {
+        stableSystem: (ctx) => `${SEMA_IDENTITY}\n\n${ctx.userSystemPrompt ?? DEFAULT_SYSTEM_PROMPT}`,
+    };
+}
+export function buildScenarios(deps) {
+    return {
+        default: (req) => {
+            const reqWebSearch = deps.requirePrincipal !== true
+                ? webSearchConfigFromSettings(req?.settings?.webSearch)
+                : undefined;
+            const webSearch = reqWebSearch ? createWebSearchBackend(reqWebSearch) : deps.webSearch;
+            return {
+                tools: [
+                    nowTool(),
+                    ...assembleFullBodyTools({
+                        todoWrite: false,
+                        taskList: true,
+                        subagent: { runner: deps.subRunner, background: { registry: defaultTaskRegistry } },
+                        ...(webSearch ? { webSearch } : {}),
+                    }).filter((t) => t.name !== "WebFetch" || deps.requirePrincipal !== true),
+                ],
+                skills: skillsForScenario(deps.skills, "default"),
+                ...(deps.brandIdentity ? { promptProvider: semaIdentityProvider() } : {}),
+            };
+        },
+        "code-review": (req) => codeReview(deps, req),
+        scan: (req) => {
+            if (!deps.repoClient)
+                throw new HttpError(501, "scan scenario needs GIT_API_BASEURL configured");
+            if (typeof req.repo !== "string" || !req.repo.trim()) {
+                throw new HttpError(400, "scan scenario requires a 'repo' field (owner/name or repo URL)");
+            }
+            return {
+                tools: [...repoToolsFor(deps.repoClient, parseRepo(req.repo)), nowTool()],
+                skills: skillsForScenario(deps.skills, "scan"),
+            };
+        },
+        oa: (req, principal) => {
+            if (!deps.oaApiBaseUrl || !deps.oaServiceToken)
+                throw new HttpError(501, "oa scenario needs OA_API_BASEURL + OA_SERVICE_TOKEN configured");
+            if (!principal)
+                throw new HttpError(401, "oa scenario requires an authenticated principal (set REQUIRE_PRINCIPAL + x-agent-principal)");
+            const issueTool = deps.oaIssue
+                ? [createGiteaIssueTool({ ...deps.oaIssue, name: "open_gitea_issue", description: "把用户的 bug/需求开成 Gitea issue 报给老板。只填 title(简洁)/body(现象、影响、复现/建议)。仓库与标签由部署固定。" })]
+                : [];
+            return {
+                tools: [...oaTools({ baseUrl: deps.oaApiBaseUrl, token: deps.oaServiceToken, principal }), ...issueTool],
+                skills: skillsForScenario(deps.skills, "oa"),
+                promptProvider: oaPrompt,
+            };
+        },
+        team: (req) => {
+            const name = typeof req.team === "string" ? req.team : "default";
+            const template = getTeam(name);
+            if (!template) {
+                throw new HttpError(404, `unknown team "${name}" (available: ${teamNames().join(", ")})`);
+            }
+            const objective = typeof req.objective === "string" ? req.objective : "Discuss the task.";
+            const businessContext = typeof req.businessContext === "string" ? req.businessContext : undefined;
+            return {
+                tools: [createTeamTool(deps.subRunner, template, { objective, businessContext })],
+                skills: skillsForScenario(deps.skills, "team"),
+                promptProvider: teamCoordinatorPrompt,
+            };
+        },
+    };
+}
+export function selectScenario(scenarios, name) {
+    return (name && scenarios[name]) || scenarios.default;
+}
+export function builtinScenarioDetails(scenarios, deps) {
+    const probe = (name, req, principal, fallback) => {
+        try {
+            return (scenarios[name]?.(req, principal)?.tools ?? []).map((t) => t.name);
+        }
+        catch {
+            return fallback;
+        }
+    };
+    const REPO_TOOLS = ["repo_tree", "repo_read_file", "repo_pull_diff", "Now"];
+    const mk = (name, summary, toolset, tools, promptSummary) => ({ name, source: "builtin", builtin: true, summary, toolset, tools, promptSummary, enabled: true });
+    return {
+        default: mk("default", "通用编码/助理主场景(CC agent loop 全量工具面)", "full-body", probe("default", {}, undefined, ["Now"]), deps.brandIdentity ? "Sema 产品身份 + core 默认宪法(结构层由引擎合成)" : "core 默认宪法(中性,无场景附加 persona)"),
+        "code-review": mk("code-review", "代码评审(clone-free 只读仓库工具;council=true 升多镜头评审团)", "repo-readonly", probe("code-review", { repo: "probe/probe" }, undefined, REPO_TOOLS), "评审员/评审团协调提示词(镜头分工+产出契约)"),
+        scan: mk("scan", "中性只读仓库扫描(输出契约由 objective+skills 决定)", "repo-readonly", probe("scan", { repo: "probe/probe" }, undefined, REPO_TOOLS), "无场景附加提示词(objective+center skills 拥有输出契约)"),
+        oa: mk("oa", "OA 资产运营助手(以最终用户 principal 走 OA API,RBAC+审计在 OA 侧)", "oa-api", probe("oa", {}, "probe:meta", ["oa_schema", "oa_alerts", "oa_list", "oa_get", "oa_lookup", "oa_create", "oa_update", "oa_transition"]), "OA 运营助手提示词(先 schema 后操作、写走受控流转)"),
+        team: mk("team", "多智能体团队圆桌(模板成员+synthesizer,模板可由 registry 配置)", "team", probe("team", {}, undefined, ["run_team"]), "团队协调者提示词(圆桌纪律+合成流程)"),
+    };
+}
+export function centerScenarioDetails(specs, builtinNames) {
+    const out = {};
+    for (const spec of specs ?? []) {
+        if (spec.enabled === false)
+            continue;
+        if (typeof spec.name !== "string" || !SCENARIO_NAME_RE.test(spec.name))
+            continue;
+        if (!TOOLSETS[spec.toolset])
+            continue;
+        if (spec.prompt !== undefined && (typeof spec.prompt !== "string" || spec.prompt.length > SCENARIO_PROMPT_MAX))
+            continue;
+        out[spec.name] = {
+            name: spec.name,
+            source: "center",
+            builtin: builtinNames.includes(spec.name),
+            summary: "",
+            toolset: spec.toolset,
+            tools: spec.toolset === "repo-readonly" ? ["repo_tree", "repo_read_file", "repo_pull_diff", "Now"] : ["Now"],
+            promptSummary: spec.prompt ?? "",
+            enabled: true,
+        };
+    }
+    return out;
+}
+const TOOLSETS = {
+    none: { build: () => [nowTool()] },
+    "repo-readonly": {
+        requiresRepo: true,
+        build: (deps, req) => {
+            if (!deps.repoClient)
+                throw new HttpError(501, "this scenario needs GIT_API_BASEURL configured");
+            if (typeof req.repo !== "string" || !req.repo.trim()) {
+                throw new HttpError(400, "this scenario requires a 'repo' field (owner/name or repo URL)");
+            }
+            return [...repoToolsFor(deps.repoClient, parseRepo(req.repo)), nowTool()];
+        },
+    },
+};
+export const SCENARIO_NAME_RE = /^[a-z][a-z0-9-]{1,31}$/;
+export const SCENARIO_PROMPT_MAX = 4096;
+export function centerScenarios(deps, specs, builtinNames, logger) {
+    const overlay = {};
+    const shadows = [];
+    for (const spec of specs ?? []) {
+        if (spec.enabled === false)
+            continue;
+        if (typeof spec.name !== "string" || !SCENARIO_NAME_RE.test(spec.name)) {
+            logger?.warn("sema_registry_scenario_invalid", { name: String(spec?.name), reason: "name must match " + String(SCENARIO_NAME_RE) });
+            continue;
+        }
+        const toolset = TOOLSETS[spec.toolset];
+        if (!toolset) {
+            logger?.warn("sema_registry_scenario_invalid", { name: spec.name, reason: `unknown toolset "${String(spec.toolset)}" (have: ${Object.keys(TOOLSETS).join(", ")})` });
+            continue;
+        }
+        if (spec.prompt !== undefined && (typeof spec.prompt !== "string" || spec.prompt.length > SCENARIO_PROMPT_MAX)) {
+            logger?.warn("sema_registry_scenario_invalid", { name: spec.name, reason: `prompt must be a string ≤${SCENARIO_PROMPT_MAX} chars` });
+            continue;
+        }
+        const promptProvider = spec.prompt ? stablePrompt(spec.prompt) : undefined;
+        const name = spec.name;
+        overlay[name] = (req) => ({
+            tools: toolset.build(deps, req),
+            skills: skillsForScenario(deps.skills, name),
+            ...(promptProvider ? { promptProvider } : {}),
+        });
+        if (builtinNames.includes(name))
+            shadows.push(name);
+    }
+    return { overlay, shadows };
+}
+function codeReview(deps, req) {
+    if (!deps.repoClient)
+        throw new HttpError(501, "code-review scenario needs GIT_API_BASEURL configured");
+    if (typeof req.repo !== "string" || !req.repo.trim()) {
+        throw new HttpError(400, "code-review scenario requires a 'repo' field (owner/name or repo URL)");
+    }
+    const coords = parseRepo(req.repo);
+    const repoTools = repoToolsFor(deps.repoClient, coords);
+    const skills = skillsForScenario(deps.skills, "code-review");
+    const objective = typeof req.objective === "string" ? req.objective : "Review this repository.";
+    if (req.council === true) {
+        const rounds = clampRounds(req.rounds);
+        return {
+            tools: [
+                createCouncilTool(deps.subRunner, repoTools, objective, {
+                    metrics: deps.metrics,
+                    logger: deps.logger,
+                    debate: req.debate === true,
+                    ...(typeof req.lenses === "number" ? { lensCount: req.lenses } : {}),
+                    ...(rounds !== undefined ? { rounds } : {}),
+                }),
+            ],
+            skills,
+            promptProvider: coordinatorPrompt,
+        };
+    }
+    return { tools: repoTools, skills, promptProvider: directReviewerPrompt };
+}
+const reviewBody = "Produce ONE prioritized review: a short summary, then findings grouped by severity " +
+    "(blocker / major / minor), each with `path:line`, the problem, and a concrete fix. Cite real code — never invent files or symbols.";
+const directReviewerPrompt = stablePrompt("You are a senior code reviewer. Call repo_tree to map the repository, then repo_read_file to read " +
+    "the files in scope, then review them yourself. " +
+    reviewBody);
+const coordinatorPrompt = stablePrompt("You coordinate a code-review council. Call `run_council` exactly once (no arguments). When it " +
+    "returns the arbitrated review, output that review as your final answer VERBATIM — do not " +
+    "summarize, shorten, or rewrite it.");
+export function mergeUserSkills(scenarioSkills, userSkills, logger) {
+    if (!userSkills || userSkills.length === 0)
+        return scenarioSkills;
+    const reserved = new Set((scenarioSkills ?? []).map((s) => s.name));
+    const out = [...(scenarioSkills ?? [])];
+    const dropped = [];
+    for (const s of userSkills) {
+        if (reserved.has(s.name)) {
+            dropped.push(s.name);
+            continue;
+        }
+        reserved.add(s.name);
+        out.push(s);
+    }
+    if (dropped.length > 0)
+        logger?.warn("user_skills_dropped", { reason: "name reserved by scenario (or duplicate)", names: dropped });
+    return out;
+}
+export function gateScenarioRequest(ruling, bodyScenario, defaultScenario) {
+    if (typeof bodyScenario === "string") {
+        const allowed = ruling?.allowlist ?? [];
+        if (allowed.length > 0 && !allowed.includes(bodyScenario)) {
+            throw new HttpError(400, `scenario "${bodyScenario}" is not in this principal's assigned allowlist`, {
+                code: "scenario_not_allowed",
+                extra: { allowlist: allowed },
+            });
+        }
+        return bodyScenario;
+    }
+    return ruling?.scenario ?? defaultScenario;
+}
+//# sourceMappingURL=scenarios.js.map

package/dist/capabilities/scenarios.js.map

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

package/dist/capabilities/select-environment-tool.d.ts

@@ -0,0 +1,22 @@
+import type { ToolSpec } from "@sema-agent/core";
+import { type SandboxImageResolver } from "../per-task-image.js";
+import type { ImageViewer, ImageIndexEntry, ImageListFilter } from "../plugins/tidb-image-index.js";
+export interface EnvironmentCatalog extends SandboxImageResolver {
+    list(filter: ImageListFilter): Promise<{
+        entries: ImageIndexEntry[];
+        nextCursor: string | null;
+    }>;
+}
+export declare class SessionEnvironmentSelection {
+    private readonly maxEntries;
+    private readonly map;
+    constructor(maxEntries?: number);
+    set(sessionId: string, profile: string): void;
+    get(sessionId: string | undefined): string | undefined;
+}
+export declare function selectEnvironmentTool(deps: {
+    catalog: EnvironmentCatalog;
+    selection: SessionEnvironmentSelection;
+    viewerFor: (principal: string | undefined) => ImageViewer;
+}): ToolSpec;
+//# sourceMappingURL=select-environment-tool.d.ts.map

package/dist/capabilities/select-environment-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-environment-tool.d.ts","sourceRoot":"","sources":["../../src/capabilities/select-environment-tool.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,KAAK,EAAE,WAAW,EAAqB,eAAe,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGvH,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,eAAe,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CACnG;AAMD,qBAAa,2BAA2B;IAE1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IADvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;gBACpB,UAAU,SAAO;IAC9C,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ7C,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS;CAGvD;AAaD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,2BAA2B,CAAC;IAGvC,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,KAAK,WAAW,CAAC;CAC3D,GAAG,QAAQ,CA6DX"}

package/dist/capabilities/select-environment-tool.js

@@ -0,0 +1,86 @@
+import { Type } from "typebox";
+import { resolveSandboxImageRef } from "../per-task-image.js";
+export class SessionEnvironmentSelection {
+    maxEntries;
+    map = new Map();
+    constructor(maxEntries = 4096) {
+        this.maxEntries = maxEntries;
+    }
+    set(sessionId, profile) {
+        this.map.delete(sessionId);
+        this.map.set(sessionId, profile);
+        if (this.map.size > this.maxEntries) {
+            const oldest = this.map.keys().next().value;
+            if (oldest !== undefined)
+                this.map.delete(oldest);
+        }
+    }
+    get(sessionId) {
+        return sessionId === undefined ? undefined : this.map.get(sessionId);
+    }
+}
+const capList = (caps) => Object.entries(caps ?? {})
+    .filter(([, v]) => v === true)
+    .map(([k]) => k);
+async function availableProfiles(catalog, viewer) {
+    const { entries } = await catalog.list({ ...viewer, status: "published", latestOnly: true, limit: 100 });
+    return entries.map((e) => ({ profile: e.profile, capabilities: capList(e.capabilities) }));
+}
+export function selectEnvironmentTool(deps) {
+    return {
+        name: "SelectEnvironment",
+        description: "Switch this session's sandbox environment (image profile) or discover available ones. " +
+            "Call with no arguments to list available profiles and their capabilities. " +
+            "Call with `profile` (optionally `capabilitiesNeeded`) to select one. " +
+            "The change takes effect for the NEXT task/subagent — the current sandbox is not swapped mid-run; " +
+            "running work keeps the environment it started with, and artifacts hand over via the workspace/git. " +
+            "Use this instead of hand-installing SDK-level toolchains (Android SDK, JVM, browsers, …).",
+        effect: "idempotent",
+        parameters: Type.Object({
+            profile: Type.Optional(Type.String({ description: "Target image profile name (from the available list). Omit to discover." })),
+            capabilitiesNeeded: Type.Optional(Type.Array(Type.String(), { description: "Boolean capabilities the task needs (e.g. browser, db, nestedBuild) — validated against the profile." })),
+        }),
+        execute: async (args, ctx) => {
+            const a = (args ?? {});
+            const viewer = deps.viewerFor(ctx.principal);
+            const sessionId = ctx.sessionId;
+            if (!a.profile) {
+                const available = await availableProfiles(deps.catalog, viewer);
+                return {
+                    content: JSON.stringify({ available, note: "Call SelectEnvironment({profile}) to select one; it takes effect for the next task/subagent." }),
+                    details: { mode: "discover", count: available.length },
+                };
+            }
+            const caps = (a.capabilitiesNeeded ?? []).filter((c) => typeof c === "string");
+            const resolved = await resolveSandboxImageRef({
+                profile: a.profile,
+                ...(caps.length > 0 ? { capabilitiesNeeded: caps } : {}),
+                viewer,
+                index: deps.catalog,
+            });
+            if (!resolved.ok) {
+                const available = await availableProfiles(deps.catalog, viewer);
+                return {
+                    content: JSON.stringify({ error: resolved.message, ...(caps.length > 0 ? { missing: caps } : {}), available }),
+                    details: { mode: "select-failed", profile: a.profile, status: resolved.status },
+                };
+            }
+            if (!sessionId) {
+                return { content: JSON.stringify({ error: "no session to bind the environment selection to" }), details: { mode: "select-failed" } };
+            }
+            deps.selection.set(sessionId, a.profile);
+            const entry = await deps.catalog.latestPublished(a.profile, viewer);
+            return {
+                content: JSON.stringify({
+                    ok: true,
+                    profile: a.profile,
+                    capabilities: capList(entry?.capabilities),
+                    note: "Selected. Takes effect for the NEXT task/subagent in this session — the current sandbox keeps its " +
+                        "environment; children inherit the binding at their spawn moment and never switch mid-flight.",
+                }),
+                details: { mode: "selected", profile: a.profile },
+            };
+        },
+    };
+}
+//# sourceMappingURL=select-environment-tool.js.map

package/dist/capabilities/select-environment-tool.js.map

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

package/dist/capabilities/skills.d.ts

@@ -0,0 +1,12 @@
+import type { SkillSpec } from "@sema-agent/core";
+export interface LoadedSkill {
+    spec: SkillSpec;
+    scenarios: string[];
+}
+export declare function loadSkills(dir: string): LoadedSkill[];
+export declare function skillsForScenario(loaded: LoadedSkill[], scenario: string): SkillSpec[];
+export declare function parseFrontmatter(raw: string): {
+    meta: Record<string, string>;
+    body: string;
+};
+//# sourceMappingURL=skills.d.ts.map

package/dist/capabilities/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/capabilities/skills.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAiBlD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAEhB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAoBrD;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAEtF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAW5F"}

package/dist/capabilities/skills.js

@@ -0,0 +1,50 @@
+import { readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+export function loadSkills(dir) {
+    let files;
+    try {
+        files = readdirSync(dir).filter((f) => f.endsWith(".md"));
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const file of files.sort()) {
+        const raw = readFileSync(join(dir, file), "utf8");
+        const { meta, body } = parseFrontmatter(raw);
+        const name = meta.name ?? file.replace(/\.md$/, "");
+        const description = meta.description ?? firstHeading(body) ?? name;
+        const scenarios = (meta.scenarios ?? "")
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean);
+        out.push({ spec: { name, description, content: body.trim() }, scenarios });
+    }
+    return out;
+}
+export function skillsForScenario(loaded, scenario) {
+    return loaded.filter((k) => k.scenarios.length === 0 || k.scenarios.includes(scenario)).map((k) => k.spec);
+}
+export function parseFrontmatter(raw) {
+    const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/.exec(raw);
+    if (!m)
+        return { meta: {}, body: raw };
+    const meta = {};
+    for (const line of m[1].split("\n")) {
+        const kv = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(line.trim());
+        if (kv)
+            meta[kv[1]] = kv[2].trim();
+    }
+    return { meta, body: m[2] };
+}
+function firstHeading(body) {
+    for (const line of body.split("\n")) {
+        const t = line.trim();
+        if (t.startsWith("#"))
+            return t.replace(/^#+\s*/, "");
+        if (t)
+            return t;
+    }
+    return undefined;
+}
+//# sourceMappingURL=skills.js.map