@agents-ensemble/core 0.0.0

package/dist/conductor/conductor-session.d.ts

@@ -0,0 +1,109 @@
+import type { WorkerDispatchResult } from '../dispatch/worker-dispatch.js';
+import type { OpenQuestion } from '../escalation/open-question.js';
+import type { EscalationRecord } from '../escalation/human-inquiry.js';
+import type { PermissionPolicyRules } from '../permission/permission-policy.js';
+import { PermissionPipeline } from '../permission/permission-pipeline.js';
+import type { Profile } from '../profile/types.js';
+import type { ConnectWorkerAcpFn } from '../dispatch/worker-acp-session.js';
+import { type WorkerWorktreeMode, type WorktreeRef } from '../worktree/worktree.js';
+import type { WorkerFailureRecord } from '../runtime/types.js';
+import type { ConductorSendResult } from './conductor-agent.js';
+import { SessionLogger } from './session/session-logger.js';
+import { type IssueLoopStopReason } from './session-policy.js';
+import type { SessionUsageSummary } from '../usage/types.js';
+import type { OperatorInputBinding } from './operator-input-binding.js';
+export type { OperatorInputContext } from './operator-input-binding.js';
+export type { OperatorInputBinding, OperatorInputBindingApi, } from './operator-input-binding.js';
+export interface RunConductorSessionOptions {
+    issueUrl: string;
+    repoRoot: string;
+    conductorCwd?: string;
+    /** 作業手順・worker 定義。未指定時は loadProfile でデフォルトを解決する。 */
+    profile: Profile;
+    profilePath?: string;
+    resumeAgentId?: string;
+    apiKey?: string;
+    modelId?: string;
+    maxTurns?: number;
+    permissionPolicy?: PermissionPolicyRules;
+    permissionPipeline?: PermissionPipeline;
+    /**
+     * 非ブロッキングのオペレータ入力。`submit` で `operator.message` をキューへ積む。
+     */
+    bindOperatorInput?: OperatorInputBinding;
+    /**
+     * conductor `agent.send` が error でもループを継続する（TTY 等でオペレータが再試行できるとき）。
+     * 非 TTY / CI では false のままにすること。
+     */
+    continueOnConductorError?: boolean;
+    /**
+     * 自律ループ停止後も harness を維持し、オペレータの `/exit` または追加指示を待つ。
+     * CLI の TTY デフォルト。非 TTY / CI では false。
+     */
+    waitForOperatorExit?: boolean;
+    /** `waitForOperatorExit` 時、自律ループ停止直後に呼ぶ（CLI の案内表示等）。 */
+    onPostLoopWait?: () => void;
+    /** integration 等で Fake ACP に差し替える。未指定時は実 `agent acp`。 */
+    connectAcp?: ConnectWorkerAcpFn;
+    /**
+     * Conductor が worker 向け作業ディレクトリをどう用意するか。
+     * セッション開始時に 1 回だけ resolve し、全 worker が共有する。
+     */
+    workerWorktreeMode?: WorkerWorktreeMode;
+    /** テスト用。未指定時は `workerWorktreeMode` から resolve する。 */
+    workerWorktree?: WorktreeRef;
+    /** integration の共有 bridge 注入時は false。 */
+    ownsWorkerAcpConnections?: boolean;
+    /** テスト用。SDK が返さない context limit の代替（利用率算出用）。 */
+    contextLimitTokens?: number;
+    onWorkerDispatched?: (result: WorkerDispatchResult) => void;
+    onWorkerFailed?: (failure: WorkerFailureRecord) => void;
+    /** `agent.send` 完了ごと（CLI 進捗ログ等）。 */
+    onSendComplete?: (info: {
+        sendCount: number;
+        runId: string;
+        status: ConductorSendResult['status'];
+        result?: string;
+        error?: ConductorSendResult['error'];
+        workerDispatches: number;
+        workerFailures: number;
+    }) => void;
+    onEscalated?: (record: EscalationRecord) => void;
+    onOpenQuestionEnqueued?: (question: OpenQuestion) => void;
+    /** テスト用。未指定時は内部で生成する。 */
+    sessionLogger?: SessionLogger;
+    /** テスト用。未指定時は内部 AbortController に SIGINT/SIGTERM を結線する。 */
+    shutdownSignal?: AbortSignal;
+    /** デフォルト true。`shutdownSignal` 未指定時のみ有効。 */
+    registerProcessSignalHandlers?: boolean;
+    /** GitHub Issue / PR 監視を無効化する。 */
+    disableGitHubMonitor?: boolean;
+    /** GitHub 更新通知の debounce（ms）。デフォルト 30s。 */
+    githubMonitorDebounceMs?: number;
+    /** GitHub 監視の通常 poll 間隔（ms）。デフォルト 60s。 */
+    githubMonitorPollIntervalMs?: number;
+    /** CI pending 時の poll 間隔（ms）。デフォルト 15s。 */
+    githubMonitorActivePollIntervalMs?: number;
+}
+export interface ConductorSessionResult {
+    agentId: string;
+    issueUrl: string;
+    repoRoot: string;
+    /** 完了した `agent.send` 回数。 */
+    sendCount: number;
+    stopReason: IssueLoopStopReason;
+    lastRunStatus: string;
+    lastResult?: string;
+    lastError?: {
+        message: string;
+        code?: string;
+    };
+    workerDispatches: WorkerDispatchResult[];
+    workerFailures: WorkerFailureRecord[];
+    escalations: EscalationRecord[];
+    openQuestions: OpenQuestion[];
+    /** harness が蓄積した LLM usage サマリ（ラウンド無しのときは省略）。 */
+    sessionUsage?: SessionUsageSummary;
+}
+export declare function runConductorSession(options: RunConductorSessionOptions): Promise<ConductorSessionResult>;
+//# sourceMappingURL=conductor-session.d.ts.map

package/dist/conductor/conductor-session.d.ts.map

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