@borgee/agents-host 0.2.73 → 0.2.84

package/dist/providers/create-provider.js

@@ -30,9 +30,23 @@ class ProviderV2CompatibilityAdapter {
             turn: preparedTurn,
         }, options);
     }
+    onAutonomousReply(handler) {
+        this.provider.onAutonomousReply?.(handler);
+    }
     async cancelTurn(channelId) {
         return this.provider.cancelTurn?.(channelId) ?? false;
     }
+    async interruptTurn(channelId) {
+        return this.provider.interruptTurn?.(channelId) ?? false;
+    }
+    async cancelSession(channelId) {
+        return this.provider.cancelSession?.(channelId)
+            ?? this.provider.cancelTurn?.(channelId)
+            ?? false;
+    }
+    async cancelBackgroundRun(channelId, providerRunId) {
+        return this.provider.cancelBackgroundRun?.(channelId, providerRunId) ?? false;
+    }
     async dispose() {
         await this.provider.shutdown?.();
     }
@@ -50,9 +64,28 @@ class CliBackedProviderV2 {
         // session as it runs, so before this point there is nothing to report.
         return { ...parseProviderReply(text), sessionId: this.cli.sessionIdForChannel(input.turn.channelId) };
     }
+    onAutonomousReply(handler) {
+        this.cli.onAutonomousReply?.(handler
+            ? (reply) => {
+                const parsed = parseProviderReply(reply.text);
+                if (parsed.text.trim()) {
+                    handler({ ...reply, text: parsed.text });
+                }
+            }
+            : undefined);
+    }
     async cancelTurn(channelId) {
         return this.cli.cancelTurn(channelId);
     }
+    async interruptTurn(channelId) {
+        return this.cli.interruptTurn(channelId);
+    }
+    async cancelSession(channelId) {
+        return this.cli.cancelSession(channelId);
+    }
+    async cancelBackgroundRun(channelId, providerRunId) {
+        return this.cli.cancelBackgroundRun?.(channelId, providerRunId) ?? false;
+    }
     async shutdown() {
         await this.cli.dispose();
     }

package/dist/providers/provider-adapter.d.ts

@@ -1,4 +1,4 @@
-import type { ProviderGenerateOptions, ProviderInput, ProviderReply } from '../types.js';
+import type { ProviderAutonomousReply, ProviderGenerateOptions, ProviderInput, ProviderReply } from '../types.js';
 export type ProviderImageInputSupport = 'supported' | 'metadata-only' | 'not-supported';
 export type ProviderImageTransportSupport = 'supported' | 'not-supported';
 export type ProviderImageTransportSource = 'transport-derived' | 'runtime-derived';
@@ -24,12 +24,23 @@ export interface ProviderImageCapability {
     sharedHostFallback: SharedHostAttachmentMetadataFallbackCapability;
     transport: ProviderImageTransportCapability;
 }
+export interface ProviderProgressUpdatesCapability {
+    support: 'supported' | 'not-supported';
+}
+export interface ProviderBackgroundRunsCapability {
+    lifecycle: 'supported' | 'not-supported';
+    targetedCancellation: 'supported' | 'not-supported';
+}
 export interface ProviderCapabilities {
     imageInput: ProviderImageCapability;
+    progressUpdates: ProviderProgressUpdatesCapability;
+    backgroundRuns?: ProviderBackgroundRunsCapability;
 }
 export declare const SHARED_HOST_ATTACHMENT_METADATA_FALLBACK: SharedHostAttachmentMetadataFallbackCapability;
 export declare function createHostedProviderCapabilities(params: {
     imageInputTransport: ProviderImageTransportCapability;
+    progressUpdates: ProviderProgressUpdatesCapability;
+    backgroundRuns?: ProviderBackgroundRunsCapability;
     sharedHostFallback?: SharedHostAttachmentMetadataFallbackCapability;
 }): ProviderCapabilities;
 export declare const TEXT_ONLY_HOSTED_PROVIDER_CAPABILITIES: ProviderCapabilities;
@@ -42,6 +53,10 @@ export declare class ProviderTurnCancelledError extends Error {
 export interface ProviderAdapter {
     readonly capabilities: ProviderCapabilities;
     generateReply(input: ProviderInput, options?: ProviderGenerateOptions): Promise<ProviderReply>;
+    onAutonomousReply?(handler: ((reply: ProviderAutonomousReply) => void) | undefined): void;
+    interruptTurn?(channelId: string): Promise<boolean>;
+    cancelSession?(channelId: string): Promise<boolean>;
     cancelTurn?(channelId: string): Promise<boolean>;
+    cancelBackgroundRun?(channelId: string, providerRunId: string): Promise<boolean>;
     dispose?(): Promise<void>;
 }

package/dist/providers/provider-adapter.js

@@ -32,6 +32,12 @@ export function createHostedProviderCapabilities(params) {
             sharedHostFallback,
             transport,
         }),
+        progressUpdates: Object.freeze({ ...params.progressUpdates }),
+        backgroundRuns: Object.freeze({
+            lifecycle: 'not-supported',
+            targetedCancellation: 'not-supported',
+            ...params.backgroundRuns,
+        }),
     });
 }
 export const TEXT_ONLY_HOSTED_PROVIDER_CAPABILITIES = createHostedProviderCapabilities({
@@ -41,6 +47,13 @@ export const TEXT_ONLY_HOSTED_PROVIDER_CAPABILITIES = createHostedProviderCapabi
         reason: 'transport-does-not-deliver-real-media',
         delivery: [],
     },
+    progressUpdates: {
+        support: 'supported',
+    },
+    backgroundRuns: {
+        lifecycle: 'not-supported',
+        targetedCancellation: 'not-supported',
+    },
 });
 export class ProviderTurnCancelledError extends Error {
     publicReplyText;

package/dist/types.d.ts

@@ -12,8 +12,12 @@ export interface ProviderCommandConfig {
     providerIdleShutdownMinutes: number;
     /**
      * Whether this agents-host may let a hosted agent enter an independent
-     * execution.local_directory workspace for a task thread created by another
-     * agent. Undefined keeps the default allow behavior.
+     * execution.local_directory working folder for a task thread created by
+     * another agent. Undefined keeps the default allow behavior.
+     *
+     * The name mirrors the operator-facing `ALLOW_CROSS_AGENT_INDEPENDENT_WORKSPACE_HANDOFF`
+     * environment variable and the identically named agent YAML key, so it keeps
+     * their spelling.
      */
     allowCrossAgentIndependentWorkspaceHandoff?: boolean;
 }
@@ -337,22 +341,22 @@ export interface TaskAssignmentThreadContext {
     active: true;
     currentTaskId?: string;
 }
-export interface ChannelResolvedWorkspaceContext {
+export interface ChannelResolvedWorkingFolderContext {
     authority: 'channel';
     owningChannelId: string;
     rootPath: string;
 }
-export interface TaskThreadScratchWorkspaceContext {
+export interface TaskThreadScratchWorkingFolderContext {
     authority: 'task-thread-scratch';
     rootPath: string;
     reason?: 'missing-or-invalid-execution-target' | 'cross-agent-independent-workspace-disabled';
 }
-export interface TaskExecutionTargetResolvedWorkspaceContext {
+export interface TaskExecutionTargetResolvedWorkingFolderContext {
     authority: 'task-execution-target';
     taskId: string;
     rootPath: string;
 }
-export type ResolvedWorkspaceContext = ChannelResolvedWorkspaceContext | TaskThreadScratchWorkspaceContext | TaskExecutionTargetResolvedWorkspaceContext;
+export type ResolvedWorkingFolderContext = ChannelResolvedWorkingFolderContext | TaskThreadScratchWorkingFolderContext | TaskExecutionTargetResolvedWorkingFolderContext;
 export interface RuntimeSurface {
     schemaVersion: 1;
     turnMode: ProviderCollaborationTurnMode;
@@ -397,7 +401,7 @@ export interface PreparedPromptContext {
     skillRuntime?: SkillRuntimeBootstrapMetadata;
     localhostGateway?: LocalhostGatewayBootstrapMetadata;
     taskAssignmentContext?: TaskAssignmentThreadContext;
-    resolvedWorkspace?: ResolvedWorkspaceContext;
+    resolvedWorkingFolder?: ResolvedWorkingFolderContext;
     runtimeSurface?: RuntimeSurface;
 }
 export interface PreparedProviderSessionRouting {
@@ -536,11 +540,25 @@ export interface ProviderCompactionProgress {
     contextWindowTokens?: number;
     failureReason?: string;
 }
+export interface ProviderBackgroundRunProgress {
+    providerRunId: string;
+    label: string;
+    state: 'running' | 'waiting' | 'completed' | 'failed' | 'cancelled' | 'unknown';
+    startedAt?: number;
+    finishedAt?: number;
+    reason?: string;
+    stopSupported: boolean;
+}
+export interface ProviderAutonomousReply {
+    channelId: string;
+    eventId: string;
+    text: string;
+}
 /**
- * A plan, a tool call and a stream of text are three meanings with three
- * cardinalities and three update rules, so they travel as three shapes rather
- * than as one entry with a category field. Text is cumulative rather than a
- * delta, so a consumer that misses one update recovers on the next.
+ * Turn text, plans, activities, compaction, and provider-owned background runs
+ * have different identities and lifetimes, so they travel as separate shapes.
+ * Text is cumulative rather than a delta, so a consumer that misses one update
+ * recovers on the next.
  */
 export type ProviderProgressUpdate = {
     type: 'text';
@@ -556,6 +574,9 @@ export type ProviderProgressUpdate = {
 } | {
     type: 'compaction';
     compaction: ProviderCompactionProgress;
+} | {
+    type: 'background_run';
+    run: ProviderBackgroundRunProgress;
 };
 export interface ProviderGenerateOptions {
     onProgress?: (update: ProviderProgressUpdate) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@borgee/agents-host",
-  "version": "0.2.73",
+  "version": "0.2.84",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -25,6 +25,7 @@
     "@agentclientprotocol/claude-agent-acp": "0.64.0",
     "@agentclientprotocol/codex-acp": "1.1.7",
     "@agentclientprotocol/sdk": "1.3.0",
+    "@github/copilot-sdk": "1.0.11",
     "cross-spawn": "^7.0.6",
     "yaml": "^2.8.1"
   },
@@ -35,7 +36,7 @@
     "tsx": "^4.20.5",
     "typescript": "^5.9.3",
     "vitest": "^4.1.5",
-    "@borgee/plugin-sdk": "0.12.5"
+    "@borgee/plugin-sdk": "0.12.8"
   },
   "scripts": {
     "predev": "pnpm --filter @borgee/plugin-sdk build",

package/skills/borgee-agent/references/task-properties.md

@@ -21,8 +21,8 @@ The key set is closed; writing an unregistered key is rejected with `unknown_pro
 | --- | --- |
 | `link.pr` | The pull request that implements this task. Set it as soon as the PR exists, not at the end. |
 | `link.issue` | The issue or ticket the task originates from. |
-| `execution.local_directory` | The explicit local directory a human selected as this task thread's execution target. New tasks default it from the immediately previous task thread in the same channel: if that previous task carried a value, the new task inherits it; if the previous task left it unset, the new task also starts unset. Hosted agents can read it, but the generic agent task-property rail must not write it. Humans set it through the existing user rail. The extra single-human-user guard applies when a task thread is about to switch into somebody's own local workspace/project directory, not as a blanket rule on every property write. A separate agents-host local policy switch governs whether a hosted agent may enter an independent workspace for a task thread that originated from another agent's task. |
-| `workspace.mode` | The host-managed scratch-workspace isolation hint for task threads. `inherit` keeps the scratch workspace on the shared host-managed path, while `isolated` reserves the task's own host-managed scratch workspace shape. Deleting the key returns to the default `inherit` behavior. |
+| `execution.local_directory` | The explicit local directory a human selected as this task thread's execution target. New tasks default it from the immediately previous task thread in the same channel: if that previous task carried a value, the new task inherits it; if the previous task left it unset, the new task also starts unset. Hosted agents can read it, but the generic agent task-property rail must not write it. Humans set it through the existing user rail. The extra single-human-user guard applies when a task thread is about to switch into somebody's own local project directory, not as a blanket rule on every property write. A separate agents-host local policy switch governs whether a hosted agent may enter an independent working folder for a task thread that originated from another agent's task. |
+| `workspace.mode` | The host-managed scratch working-folder isolation hint for task threads. `inherit` keeps the scratch working folder on the shared host-managed path, while `isolated` reserves the task's own host-managed scratch working folder shape. Deleting the key returns to the default `inherit` behavior. |
 | `agent.session_id` | Do not write this. It is registered, so a write is accepted and lands — overwriting the host's record of which provider session worked this task. The host writes it itself after each turn. |
 
 ## One key per call
@@ -31,4 +31,4 @@ Each call writes exactly one key, and that is what makes it safe to write a prop
 
 ## Value
 
-A value is a plain string of at most 8 KiB; a longer one is rejected with `property_value_too_long`. It is a reference — a URL, an identifier — never a document. `execution.local_directory` must be a non-empty absolute path string. Before a human lets a task thread switch into their own local workspace/project directory, first verify that the task's parent channel has exactly one human user; otherwise keep the thread discussion-only. If a hosted agent is trying to enter an independent workspace for a task thread that originated from another agent's task, this agents-host's local handoff policy must also allow it. Some registered keys are closed enums: `workspace.mode` accepts only `inherit` or `isolated`.
+A value is a plain string of at most 8 KiB; a longer one is rejected with `property_value_too_long`. It is a reference — a URL, an identifier — never a document. `execution.local_directory` must be a non-empty absolute path string. Before a human lets a task thread switch into their own local project directory, first verify that the task's parent channel has exactly one human user; otherwise keep the thread discussion-only. If a hosted agent is trying to enter an independent working folder for a task thread that originated from another agent's task, this agents-host's local handoff policy must also allow it. Some registered keys are closed enums: `workspace.mode` accepts only `inherit` or `isolated`.

package/skills/borgee-agent/scripts/borgee-agent.mjs

@@ -338,7 +338,7 @@ function validateCommand(parsed) {
 }
 
 // The credential path is used exactly as handed over: no walk-up, no glob, no environment lookup.
-// Task workspaces live inside the git repository and are not gitignored, so any search would
+// Task working folders live inside the git repository and are not gitignored, so any search would
 // traverse attacker-influenceable directories where a planted file could redirect the gateway base
 // URL or point at another channel's credentials.
 async function readGatewayCredential(gatewayCredentialPath) {

package/skills/borgee-agent/scripts/borgee-agent.py

@@ -300,7 +300,7 @@ def validate_command(parsed: dict[str, object]) -> None:
 
 
 # The credential path is used exactly as handed over: no walk-up, no glob, no environment lookup.
-# Task workspaces live inside the git repository and are not gitignored, so any search would
+# Task working folders live inside the git repository and are not gitignored, so any search would
 # traverse attacker-influenceable directories where a planted file could redirect the gateway base
 # URL or point at another channel's credentials.
 def read_gateway_credential(gateway_credential_path: str) -> dict[str, str]:

package/dist/context/resolved-workspace.d.ts

@@ -1,3 +0,0 @@
-import type { PreparedPromptContext, ProviderKind } from '../types.js';
-export declare function buildResolvedWorkspaceGuidanceLines(context: PreparedPromptContext | undefined, provider?: ProviderKind): string[];
-export declare function isDiscussionOnlyResolvedWorkspace(context: PreparedPromptContext | undefined): boolean;

package/dist/context/resolved-workspace.js

@@ -1,106 +0,0 @@
-function buildWorkspaceRootLine(context) {
-    const resolvedWorkspace = context.resolvedWorkspace;
-    if (!resolvedWorkspace) {
-        return undefined;
-    }
-    if (resolvedWorkspace.authority === 'task-execution-target') {
-        return `Explicit execution local directory for this task thread: ${resolvedWorkspace.rootPath}.`;
-    }
-    if (resolvedWorkspace.authority === 'task-thread-scratch') {
-        return `Discussion-only scratch workspace for this task thread: ${resolvedWorkspace.rootPath}.`;
-    }
-    if (context.taskAssignmentContext?.active === true) {
-        return `Writable workspace root inherited from this task thread's channel: ${resolvedWorkspace.rootPath}.`;
-    }
-    return `Writable workspace root for this channel: ${resolvedWorkspace.rootPath}.`;
-}
-function buildWorkspaceModeLine(context) {
-    if (context.taskAssignmentContext?.active !== true || !context.resolvedWorkspace) {
-        return undefined;
-    }
-    if (context.resolvedWorkspace.authority === 'task-execution-target') {
-        return 'This task thread has a valid explicit execution.local_directory target, so execution is bound to that exact existing local directory.';
-    }
-    if (context.resolvedWorkspace.authority === 'task-thread-scratch') {
-        return context.resolvedWorkspace.reason === 'cross-agent-independent-workspace-disabled'
-            ? 'This task thread has an explicit execution.local_directory target, but this agents-host currently disables cross-agent independent-workspace handoff, so it is discussion-only.'
-            : 'This task thread has no valid explicit execution.local_directory target, so it is discussion-only.';
-    }
-    return 'This task thread inherits the channel workspace rather than using a task-isolated workspace.';
-}
-function buildWorkspaceLocalityLine(context) {
-    if (!context.resolvedWorkspace) {
-        return undefined;
-    }
-    if (context.resolvedWorkspace.authority === 'task-execution-target') {
-        return 'This is a human-selected existing local directory. The host validates it before use and never creates it.';
-    }
-    if (context.resolvedWorkspace.authority === 'task-thread-scratch') {
-        return 'This scratch workspace is host-managed only for discussion turns. It is not a bound project workspace and does not imply that any target repository is checked out there.';
-    }
-    if (context.taskAssignmentContext?.active === true) {
-        return 'This writable workspace is local to agents-host for this task thread because the task inherits its channel workspace. It does not imply that the target repository has already been checked out there.';
-    }
-    return 'This writable workspace is local to agents-host for this channel. It does not imply that the target repository has already been checked out there.';
-}
-function buildCopilotCwdLine(context) {
-    if (!context.resolvedWorkspace) {
-        return undefined;
-    }
-    if (context.resolvedWorkspace.authority === 'task-execution-target') {
-        return 'GitHub Copilot runs this turn with that exact local directory as its real cwd.';
-    }
-    if (context.resolvedWorkspace.authority === 'task-thread-scratch') {
-        return 'GitHub Copilot runs this turn with that host-managed scratch workspace as its real cwd.';
-    }
-    if (context.taskAssignmentContext?.active === true) {
-        return 'GitHub Copilot runs this turn with that inherited channel workspace as its real cwd.';
-    }
-    return 'GitHub Copilot runs this turn with that workspace as its real cwd.';
-}
-function buildDiscussionOnlyPermissionLine(context) {
-    if (context.resolvedWorkspace?.authority !== 'task-thread-scratch') {
-        return undefined;
-    }
-    return context.resolvedWorkspace.reason === 'cross-agent-independent-workspace-disabled'
-        ? 'Filesystem and shell tool permissions stay denied in this discussion-only task thread while this agents-host keeps cross-agent independent-workspace handoff disabled.'
-        : 'Filesystem and shell tool permissions stay denied in this discussion-only task thread until a human sets a valid execution.local_directory target.';
-}
-function buildProjectEntryPrecheckLine(context) {
-    if (context.taskAssignmentContext?.active !== true) {
-        return undefined;
-    }
-    if (context.resolvedWorkspace?.authority === 'task-execution-target') {
-        return 'Precheck before switching this task thread into your own local workspace or project directory: the task\'s parent channel must have exactly one human user. Cross-agent independent-workspace handoff is also governed by this agents-host\'s local policy switch.';
-    }
-    return 'Before a human switches this task thread into their own local workspace or project directory, verify that the task\'s parent channel has exactly one human user; otherwise keep the thread discussion-only. Cross-agent independent-workspace handoff is also governed by this agents-host\'s local policy switch.';
-}
-export function buildResolvedWorkspaceGuidanceLines(context, provider) {
-    if (!context?.resolvedWorkspace) {
-        return [];
-    }
-    const lines = [buildWorkspaceRootLine(context), buildWorkspaceModeLine(context)]
-        .filter((line) => line != null);
-    if (provider === 'copilot') {
-        const copilotCwdLine = buildCopilotCwdLine(context);
-        if (copilotCwdLine) {
-            lines.push(copilotCwdLine);
-        }
-    }
-    const localityLine = buildWorkspaceLocalityLine(context);
-    if (localityLine) {
-        lines.push(localityLine);
-    }
-    const permissionLine = buildDiscussionOnlyPermissionLine(context);
-    if (permissionLine) {
-        lines.push(permissionLine);
-    }
-    const precheckLine = buildProjectEntryPrecheckLine(context);
-    if (precheckLine) {
-        lines.push(precheckLine);
-    }
-    return lines;
-}
-export function isDiscussionOnlyResolvedWorkspace(context) {
-    return context?.resolvedWorkspace?.authority === 'task-thread-scratch';
-}