@agents-ensemble/core 0.0.0

package/dist/session/session-sidecar.js

@@ -0,0 +1,158 @@
+import { mkdir, readdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+export const SESSION_SIDECAR_VERSION = 1;
+export class SessionSidecarNotFoundError extends Error {
+    conductorAgentId;
+    path;
+    code = 'SESSION_SIDECAR_NOT_FOUND';
+    constructor(conductorAgentId, path) {
+        super(`Session sidecar not found for resume (agentId=${conductorAgentId}, path=${path})`);
+        this.conductorAgentId = conductorAgentId;
+        this.path = path;
+        this.name = 'SessionSidecarNotFoundError';
+    }
+}
+export function sessionSidecarDir(repoRoot) {
+    return join(repoRoot, '.ensemble', 'sessions');
+}
+export function sessionSidecarPath(options) {
+    return join(sessionSidecarDir(options.repoRoot), `${options.conductorAgentId}.json`);
+}
+export async function loadSessionSidecar(path) {
+    try {
+        const raw = await readFile(path, 'utf8');
+        return parseSessionSidecar(JSON.parse(raw));
+    }
+    catch (error) {
+        if (isEnoent(error))
+            return undefined;
+        throw error;
+    }
+}
+/** `resumeAgentId` 指定時に sidecar が無い場合は起動失敗とする。 */
+export async function requireSessionSidecarForResume(input) {
+    const path = sessionSidecarPath(input);
+    const sidecar = await loadSessionSidecar(path);
+    if (!sidecar) {
+        throw new SessionSidecarNotFoundError(input.conductorAgentId, path);
+    }
+    return sidecar;
+}
+export async function saveSessionSidecar(path, sidecar) {
+    const parsed = parseSessionSidecar({
+        ...sidecar,
+        updatedAt: Date.now(),
+    });
+    await mkdir(dirname(path), { recursive: true });
+    const tempPath = `${path}.tmp`;
+    await writeFile(tempPath, `${JSON.stringify(parsed, null, 2)}\n`, 'utf8');
+    await rename(tempPath, path);
+}
+export async function listSessionSidecars(repoRoot) {
+    const dir = sessionSidecarDir(repoRoot);
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch (error) {
+        if (isEnoent(error))
+            return [];
+        throw error;
+    }
+    const sidecars = [];
+    for (const entry of entries) {
+        if (!entry.endsWith('.json') || entry.endsWith('.tmp'))
+            continue;
+        const sidecar = await loadSessionSidecar(join(dir, entry));
+        if (sidecar)
+            sidecars.push(sidecar);
+    }
+    return sidecars;
+}
+/** 同一 Issue の sidecar のうち `updatedAt` が最新のものを返す。 */
+export async function findLatestSessionSidecarForIssue(input) {
+    const matches = (await listSessionSidecars(input.repoRoot)).filter((sidecar) => sidecar.issueUrl === input.issueUrl &&
+        sidecar.repoRoot === input.repoRoot);
+    if (matches.length === 0)
+        return undefined;
+    return matches.reduce((latest, sidecar) => sidecar.updatedAt > latest.updatedAt ? sidecar : latest);
+}
+export function assertSessionSidecarMatches(sidecar, input) {
+    if (sidecar.conductorAgentId !== input.conductorAgentId) {
+        throw new Error(`Session sidecar conductorAgentId mismatch: ${sidecar.conductorAgentId} !== ${input.conductorAgentId}`);
+    }
+    if (sidecar.issueUrl !== input.issueUrl) {
+        throw new Error(`Session sidecar issueUrl mismatch: ${sidecar.issueUrl} !== ${input.issueUrl}`);
+    }
+    if (sidecar.repoRoot !== input.repoRoot) {
+        throw new Error(`Session sidecar repoRoot mismatch: ${sidecar.repoRoot} !== ${input.repoRoot}`);
+    }
+}
+function parseSessionSidecar(value) {
+    if (!value || typeof value !== 'object') {
+        throw new Error('Invalid session sidecar: not an object');
+    }
+    const record = value;
+    if (record.version !== SESSION_SIDECAR_VERSION) {
+        throw new Error(`Unsupported session sidecar version: ${record.version}`);
+    }
+    if (typeof record.conductorAgentId !== 'string') {
+        throw new Error('Invalid session sidecar: conductorAgentId');
+    }
+    if (typeof record.issueUrl !== 'string') {
+        throw new Error('Invalid session sidecar: issueUrl');
+    }
+    if (typeof record.repoRoot !== 'string') {
+        throw new Error('Invalid session sidecar: repoRoot');
+    }
+    if (!record.profile || typeof record.profile !== 'object') {
+        throw new Error('Invalid session sidecar: profile');
+    }
+    if (!Array.isArray(record.openQuestions)) {
+        throw new Error('Invalid session sidecar: openQuestions');
+    }
+    if (typeof record.sequence !== 'number') {
+        throw new Error('Invalid session sidecar: sequence');
+    }
+    if (!record.workers || typeof record.workers !== 'object') {
+        throw new Error('Invalid session sidecar: workers');
+    }
+    const updatedAt = typeof record.updatedAt === 'number' ? record.updatedAt : 0;
+    let githubMonitor;
+    if (record.githubMonitor && typeof record.githubMonitor === 'object') {
+        githubMonitor = record.githubMonitor;
+    }
+    const workers = {};
+    for (const [name, entry] of Object.entries(record.workers)) {
+        if (!entry || typeof entry !== 'object') {
+            throw new Error(`Invalid session sidecar worker entry: ${name}`);
+        }
+        const worker = entry;
+        if (typeof worker.acpSessionId !== 'string') {
+            throw new Error(`Invalid session sidecar worker acpSessionId: ${name}`);
+        }
+        workers[name] = { acpSessionId: worker.acpSessionId };
+    }
+    return {
+        version: SESSION_SIDECAR_VERSION,
+        conductorAgentId: record.conductorAgentId,
+        issueUrl: record.issueUrl,
+        repoRoot: record.repoRoot,
+        profile: record.profile,
+        ...(typeof record.profilePath === 'string'
+            ? { profilePath: record.profilePath }
+            : {}),
+        openQuestions: record.openQuestions,
+        sequence: record.sequence,
+        workers,
+        ...(githubMonitor ? { githubMonitor } : {}),
+        updatedAt,
+    };
+}
+function isEnoent(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        error.code === 'ENOENT');
+}
+//# sourceMappingURL=session-sidecar.js.map

package/dist/session/session-sidecar.js.map

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

package/dist/usage/estimate-token-usage.d.ts

@@ -0,0 +1,7 @@
+import type { LlmUsageRecord } from './types.js';
+/** UTF-8 バイト長 ÷ 4 の切り上げ。worker ACP で usage 未報告時の近似。 */
+export declare function estimateTokenUsageFromText(input: {
+    promptText?: string;
+    responseText?: string;
+}): LlmUsageRecord;
+//# sourceMappingURL=estimate-token-usage.d.ts.map

package/dist/usage/estimate-token-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate-token-usage.d.ts","sourceRoot":"","sources":["../../src/usage/estimate-token-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,uDAAuD;AACvD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,cAAc,CASjB"}

package/dist/usage/estimate-token-usage.js

@@ -0,0 +1,18 @@
+/** UTF-8 バイト長 ÷ 4 の切り上げ。worker ACP で usage 未報告時の近似。 */
+export function estimateTokenUsageFromText(input) {
+    const inputTokens = estimateTokens(input.promptText ?? '');
+    const outputTokens = estimateTokens(input.responseText ?? '');
+    return {
+        source: 'estimated',
+        inputTokens,
+        outputTokens,
+        totalTokens: inputTokens + outputTokens,
+    };
+}
+function estimateTokens(text) {
+    if (text.length === 0) {
+        return 0;
+    }
+    return Math.ceil(Buffer.byteLength(text, 'utf8') / 4);
+}
+//# sourceMappingURL=estimate-token-usage.js.map

package/dist/usage/estimate-token-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate-token-usage.js","sourceRoot":"","sources":["../../src/usage/estimate-token-usage.ts"],"names":[],"mappings":"AAEA,uDAAuD;AACvD,MAAM,UAAU,0BAA0B,CAAC,KAG1C;IACC,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAC9D,OAAO;QACL,MAAM,EAAE,WAAW;QACnB,WAAW;QACX,YAAY;QACZ,WAAW,EAAE,WAAW,GAAG,YAAY;KACxC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/usage/session-usage-tracker.d.ts

@@ -0,0 +1,33 @@
+import type { TokenUsage } from '@cursor/sdk';
+import type { PromptResult } from '../acp/types.js';
+import type { SessionUsageRound, SessionUsageSummary } from './types.js';
+export interface SessionUsageTrackerOptions {
+    /** テスト用。SDK が limit を返さないため、指定時のみ利用率を算出する。 */
+    contextLimitTokens?: number;
+}
+export declare class SessionUsageTracker {
+    private readonly rounds;
+    private readonly contextLimitTokens?;
+    constructor(options?: SessionUsageTrackerOptions);
+    recordConductorRound(input: {
+        runId: string;
+        status: string;
+        usage?: TokenUsage;
+        modelId?: string;
+    }): SessionUsageRound;
+    recordWorkerRound(input: {
+        name: string;
+        kind: string;
+        source?: 'harness' | 'conductor';
+        prompt: string;
+        promptResult: PromptResult;
+    }): SessionUsageRound;
+    getLatestRound(filter?: {
+        agent?: 'conductor' | string;
+    }): SessionUsageRound | null;
+    getSessionSummary(): SessionUsageSummary;
+    private buildContextUtilization;
+}
+/** テスト用。 */
+export declare function resetSessionUsageRoundCounter(): void;
+//# sourceMappingURL=session-usage-tracker.d.ts.map

package/dist/usage/session-usage-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-usage-tracker.d.ts","sourceRoot":"","sources":["../../src/usage/session-usage-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAKV,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,0BAA0B;IACzC,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAS;gBAEjC,OAAO,GAAE,0BAA+B;IAIpD,oBAAoB,CAAC,KAAK,EAAE;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,UAAU,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,iBAAiB;IAerB,iBAAiB,CAAC,KAAK,EAAE;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;QACjC,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,YAAY,CAAC;KAC5B,GAAG,iBAAiB;IAuBrB,cAAc,CAAC,MAAM,CAAC,EAAE;QACtB,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;KAC9B,GAAG,iBAAiB,GAAG,IAAI;IAa5B,iBAAiB,IAAI,mBAAmB;IAoCxC,OAAO,CAAC,uBAAuB;CAsBhC;AAiGD,YAAY;AACZ,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}

package/dist/usage/session-usage-tracker.js

@@ -0,0 +1,184 @@
+import { estimateTokenUsageFromText } from './estimate-token-usage.js';
+let roundCounter = 0;
+export class SessionUsageTracker {
+    rounds = [];
+    contextLimitTokens;
+    constructor(options = {}) {
+        this.contextLimitTokens = options.contextLimitTokens;
+    }
+    recordConductorRound(input) {
+        const usage = input.usage ? fromSdkTokenUsage(input.usage) : null;
+        const round = {
+            roundId: nextRoundId(),
+            agentKind: 'conductor',
+            runId: input.runId,
+            modelId: input.modelId,
+            stopReason: input.status,
+            usage,
+            recordedAt: Date.now(),
+        };
+        this.rounds.push(round);
+        return round;
+    }
+    recordWorkerRound(input) {
+        const usage = input.promptResult.usage != null
+            ? fromAcpUsage(input.promptResult.usage)
+            : estimateTokenUsageFromText({
+                promptText: input.prompt,
+                responseText: input.promptResult.responseText,
+            });
+        const round = {
+            roundId: nextRoundId(),
+            agentKind: 'worker',
+            agentName: input.name,
+            workerKind: input.kind,
+            source: input.source,
+            stopReason: input.promptResult.stopReason,
+            usage,
+            recordedAt: Date.now(),
+        };
+        this.rounds.push(round);
+        return round;
+    }
+    getLatestRound(filter) {
+        if (!filter?.agent) {
+            return this.rounds.at(-1) ?? null;
+        }
+        if (filter.agent === 'conductor') {
+            return findLast(this.rounds, (round) => round.agentKind === 'conductor');
+        }
+        return findLast(this.rounds, (round) => round.agentKind === 'worker' && round.agentName === filter.agent);
+    }
+    getSessionSummary() {
+        const conductorRounds = this.rounds.filter((round) => round.agentKind === 'conductor');
+        const workerNames = [
+            ...new Set(this.rounds
+                .filter((round) => round.agentKind === 'worker' && round.agentName)
+                .map((round) => round.agentName)),
+        ];
+        const workers = {};
+        for (const name of workerNames) {
+            workers[name] = summarizeAgent(this.rounds.filter((round) => round.agentKind === 'worker' && round.agentName === name));
+        }
+        const allWithUsage = this.rounds.filter((round) => round.usage != null);
+        return {
+            totals: {
+                rounds: this.rounds.length,
+                roundsWithUsage: allWithUsage.length,
+                tokens: sumUsageRecords(allWithUsage.map((round) => round.usage)),
+            },
+            byAgent: {
+                conductor: summarizeAgent(conductorRounds),
+                workers,
+            },
+            context: this.buildContextUtilization(),
+            latestRound: this.getLatestRound(),
+        };
+    }
+    buildContextUtilization() {
+        const usedInputTokens = sumInputTokens(this.rounds);
+        if (this.contextLimitTokens == null || this.contextLimitTokens <= 0) {
+            return {
+                limit: null,
+                usedInputTokens,
+                percent: null,
+                limitUnavailableReason: '@cursor/sdk 1.0.27 の RunResult / ModelListItem に context limit が無い。RunConductorSessionOptions.contextLimitTokens 未指定。',
+            };
+        }
+        const percent = Math.min(100, Math.round((usedInputTokens / this.contextLimitTokens) * 100));
+        return {
+            limit: this.contextLimitTokens,
+            usedInputTokens,
+            percent,
+        };
+    }
+}
+function nextRoundId() {
+    roundCounter += 1;
+    return `usage-round-${roundCounter}`;
+}
+function fromSdkTokenUsage(usage) {
+    return {
+        source: 'sdk',
+        inputTokens: usage.inputTokens,
+        outputTokens: usage.outputTokens,
+        totalTokens: usage.totalTokens,
+        reasoningTokens: usage.reasoningTokens,
+        cacheReadTokens: usage.cacheReadTokens,
+        cacheWriteTokens: usage.cacheWriteTokens,
+    };
+}
+function fromAcpUsage(usage) {
+    return {
+        source: 'acp',
+        inputTokens: usage.inputTokens,
+        outputTokens: usage.outputTokens,
+        totalTokens: usage.totalTokens ?? usage.inputTokens + usage.outputTokens,
+        reasoningTokens: usage.reasoningTokens,
+        cacheReadTokens: usage.cacheReadTokens,
+        cacheWriteTokens: usage.cacheWriteTokens,
+    };
+}
+function summarizeAgent(rounds) {
+    const withUsage = rounds.filter((round) => round.usage != null);
+    return {
+        rounds: rounds.length,
+        roundsWithUsage: withUsage.length,
+        tokens: sumUsageRecords(withUsage.map((round) => round.usage)),
+    };
+}
+function sumUsageRecords(records) {
+    if (records.length === 0) {
+        return null;
+    }
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let totalTokens = 0;
+    let reasoningTokens = 0;
+    let cacheReadTokens = 0;
+    let cacheWriteTokens = 0;
+    let hasReasoning = false;
+    let hasCacheRead = false;
+    let hasCacheWrite = false;
+    for (const record of records) {
+        inputTokens += record.inputTokens;
+        outputTokens += record.outputTokens;
+        totalTokens += record.totalTokens;
+        if (record.reasoningTokens != null) {
+            hasReasoning = true;
+            reasoningTokens += record.reasoningTokens;
+        }
+        if (record.cacheReadTokens != null) {
+            hasCacheRead = true;
+            cacheReadTokens += record.cacheReadTokens;
+        }
+        if (record.cacheWriteTokens != null) {
+            hasCacheWrite = true;
+            cacheWriteTokens += record.cacheWriteTokens;
+        }
+    }
+    return {
+        inputTokens,
+        outputTokens,
+        totalTokens,
+        ...(hasReasoning ? { reasoningTokens } : {}),
+        ...(hasCacheRead ? { cacheReadTokens } : {}),
+        ...(hasCacheWrite ? { cacheWriteTokens } : {}),
+    };
+}
+function sumInputTokens(rounds) {
+    return rounds.reduce((sum, round) => sum + (round.usage?.inputTokens ?? 0), 0);
+}
+function findLast(items, predicate) {
+    for (let index = items.length - 1; index >= 0; index -= 1) {
+        if (predicate(items[index])) {
+            return items[index];
+        }
+    }
+    return null;
+}
+/** テスト用。 */
+export function resetSessionUsageRoundCounter() {
+    roundCounter = 0;
+}
+//# sourceMappingURL=session-usage-tracker.js.map

package/dist/usage/session-usage-tracker.js.map

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

package/dist/usage/types.d.ts

@@ -0,0 +1,53 @@
+/** Token counts for one LLM round or an aggregate. */
+export interface LlmTokenCounts {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    reasoningTokens?: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+}
+export type LlmUsageSource = 'sdk' | 'acp' | 'estimated';
+export interface LlmUsageRecord extends LlmTokenCounts {
+    source: LlmUsageSource;
+}
+export type SessionUsageAgentKind = 'conductor' | 'worker';
+export interface SessionUsageRound {
+    roundId: string;
+    agentKind: SessionUsageAgentKind;
+    /** worker 名。conductor のときは省略。 */
+    agentName?: string;
+    workerKind?: string;
+    source?: 'harness' | 'conductor';
+    runId?: string;
+    modelId?: string;
+    stopReason?: string;
+    usage: LlmUsageRecord | null;
+    recordedAt: number;
+}
+export interface SessionUsageAgentTotals {
+    rounds: number;
+    roundsWithUsage: number;
+    tokens: LlmTokenCounts | null;
+}
+export interface SessionContextUtilization {
+    limit: number | null;
+    /** limit 算出に使った累計 input tokens。limit 不明時も参考値として返す。 */
+    usedInputTokens: number;
+    percent: number | null;
+    limitUnavailableReason?: string;
+}
+export interface SessionUsageSummary {
+    totals: {
+        rounds: number;
+        roundsWithUsage: number;
+        tokens: LlmTokenCounts | null;
+    };
+    byAgent: {
+        conductor: SessionUsageAgentTotals;
+        workers: Record<string, SessionUsageAgentTotals>;
+    };
+    context: SessionContextUtilization;
+    latestRound: SessionUsageRound | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/usage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/usage/types.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC;AAEzD,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,qBAAqB,CAAC;IACjC,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;KAC/B,CAAC;IACF,OAAO,EAAE;QACP,SAAS,EAAE,uBAAuB,CAAC;QACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;KAClD,CAAC;IACF,OAAO,EAAE,yBAAyB,CAAC;IACnC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACvC"}

package/dist/usage/types.js

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

package/dist/usage/types.js.map

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

package/dist/worktree/worktree.d.ts

@@ -0,0 +1,46 @@
+import type { IssueRef } from '../issue/issue-ref.js';
+/** `isolated`: Issue 専用 worktree（既定）。`in_repo`: メイン worktree で直接作業する特別モード。 */
+export type WorkerWorktreeMode = 'isolated' | 'in_repo';
+export interface WorktreeRef {
+    path: string;
+    branch: string;
+    issue: IssueRef;
+    /** メイン worktree での直接作業（isolated worktree を使わない）。 */
+    inRepo?: boolean;
+}
+export declare function workerBranchName(issue: Pick<IssueRef, 'number'>): string;
+export declare function workerWorktreePath(repoRoot: string, issue: Pick<IssueRef, 'number'>): string;
+export declare function resolveWorkerWorktree(repoRoot: string, issue: IssueRef): Promise<WorktreeRef | undefined>;
+/** Conductor / one-shot dispatch が Issue 向け作業ディレクトリを 1 回だけ決める。 */
+export declare function resolveWorkerWorkspace(repoRoot: string, issue: IssueRef, mode?: WorkerWorktreeMode): Promise<WorktreeRef>;
+/** メイン worktree（repo root）で直接作業する。通常の isolated worktree は作らない。 */
+export declare function resolveInRepoWorkspace(repoRoot: string, issue: IssueRef): Promise<WorktreeRef>;
+export declare function createWorkerWorktree(repoRoot: string, issue: IssueRef): Promise<WorktreeRef>;
+export type RemoveWorkerWorktreeResult = {
+    status: 'removed';
+    path: string;
+    branch: string;
+} | {
+    status: 'not_found';
+} | {
+    status: 'skipped_dirty';
+    path: string;
+    branch: string;
+} | {
+    status: 'failed';
+    path: string;
+    branch: string;
+    error: string;
+};
+/**
+ * isolated worktree を削除する。存在しない場合は no-op。
+ * 未コミット変更がある場合は削除せず `skipped_dirty` を返す（`--force` は使わない）。
+ */
+export declare function removeWorkerWorktree(repoRoot: string, issue: IssueRef): Promise<RemoveWorkerWorktreeResult>;
+interface ListedWorktree {
+    path: string;
+    branch: string;
+}
+export declare function listWorktrees(repoRoot: string): Promise<ListedWorktree[]>;
+export {};
+//# sourceMappingURL=worktree.d.ts.map

package/dist/worktree/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/worktree/worktree.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,SAAS,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;IAChB,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,CAExE;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAC9B,MAAM,CAER;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CASlC;AAED,kEAAkE;AAClE,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,EACf,IAAI,GAAE,kBAA+B,GACpC,OAAO,CAAC,WAAW,CAAC,CAKtB;AAED,kEAAkE;AAClE,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,WAAW,CAAC,CAItB;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,WAAW,CAAC,CAwCtB;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,0BAA0B,CAAC,CA+BrC;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CA6B/E"}