@myagentroam/agent 0.9.159 → 0.9.160

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (128) hide show
  1. package/dist/agent-core/extensions/agents.d.ts +69 -0
  2. package/dist/agent-core/extensions/agents.js +160 -0
  3. package/dist/agent-core/extensions/contracts.d.ts +260 -0
  4. package/dist/agent-core/extensions/contracts.js +1 -0
  5. package/dist/agent-core/extensions/data.d.ts +84 -0
  6. package/dist/agent-core/extensions/data.js +83 -0
  7. package/dist/agent-core/extensions/environment.d.ts +27 -0
  8. package/dist/agent-core/extensions/environment.js +52 -0
  9. package/dist/agent-core/extensions/files.d.ts +64 -0
  10. package/dist/agent-core/extensions/files.js +26 -0
  11. package/dist/agent-core/extensions/hooks.d.ts +32 -0
  12. package/dist/agent-core/extensions/hooks.js +135 -0
  13. package/dist/agent-core/extensions/manager.d.ts +39 -0
  14. package/dist/agent-core/extensions/manager.js +458 -0
  15. package/dist/agent-core/extensions/mcp.d.ts +99 -0
  16. package/dist/agent-core/extensions/mcp.js +433 -0
  17. package/dist/agent-core/extensions/model-request.d.ts +60 -0
  18. package/dist/agent-core/extensions/model-request.js +167 -0
  19. package/dist/agent-core/extensions/model-stream.d.ts +9 -0
  20. package/dist/agent-core/extensions/model-stream.js +101 -0
  21. package/dist/agent-core/extensions/models.d.ts +43 -0
  22. package/dist/agent-core/extensions/models.js +1 -0
  23. package/dist/agent-core/extensions/network.d.ts +32 -0
  24. package/dist/agent-core/extensions/network.js +97 -0
  25. package/dist/agent-core/extensions/operation.d.ts +29 -0
  26. package/dist/agent-core/extensions/operation.js +98 -0
  27. package/dist/agent-core/extensions/processes.d.ts +52 -0
  28. package/dist/agent-core/extensions/processes.js +283 -0
  29. package/dist/agent-core/extensions/prompt-composition.d.ts +24 -0
  30. package/dist/agent-core/extensions/prompt-composition.js +106 -0
  31. package/dist/agent-core/extensions/prompt-input.d.ts +23 -0
  32. package/dist/agent-core/extensions/prompt-input.js +46 -0
  33. package/dist/agent-core/extensions/resources.d.ts +27 -0
  34. package/dist/agent-core/extensions/resources.js +221 -0
  35. package/dist/agent-core/extensions/services.d.ts +31 -0
  36. package/dist/agent-core/extensions/services.js +61 -0
  37. package/dist/agent-core/extensions/session-input.d.ts +151 -0
  38. package/dist/agent-core/extensions/session-input.js +351 -0
  39. package/dist/agent-core/extensions/session-messages.d.ts +41 -0
  40. package/dist/agent-core/extensions/session-messages.js +76 -0
  41. package/dist/agent-core/extensions/session.d.ts +68 -0
  42. package/dist/agent-core/extensions/session.js +593 -0
  43. package/dist/agent-core/extensions/settings.d.ts +59 -0
  44. package/dist/agent-core/extensions/settings.js +115 -0
  45. package/dist/agent-core/extensions/store.d.ts +10 -0
  46. package/dist/agent-core/extensions/store.js +131 -0
  47. package/dist/agent-core/extensions/tools.d.ts +61 -0
  48. package/dist/agent-core/extensions/tools.js +266 -0
  49. package/dist/agent-core/host/contracts.d.ts +25 -0
  50. package/dist/agent-core/host/local-agent-host.d.ts +10 -1
  51. package/dist/agent-core/host/local-agent-host.js +132 -20
  52. package/dist/agent-core/host/local-file-access.d.ts +30 -0
  53. package/dist/agent-core/host/local-file-access.js +107 -0
  54. package/dist/agent-core/host/local-network-access.d.ts +6 -0
  55. package/dist/agent-core/host/local-network-access.js +97 -0
  56. package/dist/agent-core/host/local-process-executor.d.ts +5 -1
  57. package/dist/agent-core/host/local-session-environment.d.ts +18 -0
  58. package/dist/agent-core/host/local-session-environment.js +102 -0
  59. package/dist/agent-core/model/anthropic-messages.js +73 -23
  60. package/dist/agent-core/model/contracts.d.ts +12 -0
  61. package/dist/agent-core/model/openai-responses.js +73 -12
  62. package/dist/agent-core/model/text-blocks.d.ts +7 -0
  63. package/dist/agent-core/model/text-blocks.js +40 -0
  64. package/dist/agent-core/prompts/index.d.ts +6 -2
  65. package/dist/agent-core/prompts/index.js +38 -24
  66. package/dist/agent-core/runtime/context/gc-tokens.js +6 -1
  67. package/dist/agent-core/runtime/context/normalize.js +21 -1
  68. package/dist/agent-core/runtime/context/projection.js +35 -1
  69. package/dist/agent-core/runtime/context/request-budget.js +5 -2
  70. package/dist/agent-core/runtime/context/restore.d.ts +5 -0
  71. package/dist/agent-core/runtime/context/restore.js +47 -4
  72. package/dist/agent-core/runtime/context/usage.js +2 -3
  73. package/dist/agent-core/runtime/contracts.d.ts +2 -0
  74. package/dist/agent-core/runtime/execution.js +5 -2
  75. package/dist/agent-core/sdk/agent.js +177 -40
  76. package/dist/agent-core/sdk/extension-agents.d.ts +9 -0
  77. package/dist/agent-core/sdk/extension-agents.js +51 -0
  78. package/dist/agent-core/sdk/extension-models.d.ts +13 -0
  79. package/dist/agent-core/sdk/extension-models.js +128 -0
  80. package/dist/agent-core/sdk/extension-session.d.ts +30 -0
  81. package/dist/agent-core/sdk/extension-session.js +103 -0
  82. package/dist/agent-core/sdk/extension-tools.d.ts +16 -0
  83. package/dist/agent-core/sdk/extension-tools.js +126 -0
  84. package/dist/agent-core/sdk/session.d.ts +26 -2
  85. package/dist/agent-core/sdk/session.js +1215 -506
  86. package/dist/agent-core/sdk/types.d.ts +3 -0
  87. package/dist/agent-core/session/context-gc-checkpoint.js +1 -1
  88. package/dist/agent-core/session/jsonl-store.d.ts +28 -8
  89. package/dist/agent-core/session/jsonl-store.js +124 -84
  90. package/dist/agent-core/session/types.d.ts +4 -1
  91. package/dist/agent-core/storage/file-lock.d.ts +4 -0
  92. package/dist/agent-core/storage/file-lock.js +83 -0
  93. package/dist/agent-core/subagent/contracts.d.ts +11 -1
  94. package/dist/agent-core/subagent/scheduler.d.ts +8 -0
  95. package/dist/agent-core/subagent/session-controller.d.ts +22 -1
  96. package/dist/agent-core/subagent/session-controller.js +355 -98
  97. package/dist/agent-core/tools/agent/agent-start.d.ts +1 -1
  98. package/dist/agent-core/tools/code-mode/cells.js +5 -15
  99. package/dist/agent-core/tools/code-mode/dispatch.d.ts +1 -0
  100. package/dist/agent-core/tools/code-mode/dispatch.js +13 -1
  101. package/dist/agent-core/tools/code-mode/index.js +1 -2
  102. package/dist/agent-core/tools/code-mode/observations.d.ts +5 -0
  103. package/dist/agent-core/tools/code-mode/observations.js +16 -5
  104. package/dist/agent-core/tools/code-mode/quickjs-engine.js +10 -5
  105. package/dist/agent-core/tools/execution.d.ts +11 -2
  106. package/dist/agent-core/tools/execution.js +58 -21
  107. package/dist/agent-core/tools/input.d.ts +2 -0
  108. package/dist/agent-core/tools/input.js +36 -0
  109. package/dist/agent-core/tools/local/apply-patch.js +21 -17
  110. package/dist/agent-core/tools/local/exec.d.ts +4 -4
  111. package/dist/agent-core/tools/local/exec.js +234 -62
  112. package/dist/agent-core/tools/local/registry.d.ts +6 -0
  113. package/dist/agent-core/tools/local/registry.js +60 -9
  114. package/dist/agent-core/tools/mcp/catalog.d.ts +6 -2
  115. package/dist/agent-core/tools/mcp/catalog.js +4 -4
  116. package/dist/agent-core/tools/mcp/history.js +2 -2
  117. package/dist/agent-core/tools/mcp/tool-search.d.ts +3 -1
  118. package/dist/agent-core/tools/mcp/tool-search.js +2 -2
  119. package/dist/agent-core/tools/output-projection.d.ts +3 -1
  120. package/dist/agent-core/tools/output-projection.js +11 -2
  121. package/dist/agent-core/tools/runtime-context.d.ts +1 -0
  122. package/dist/agent-core/tools/runtime.d.ts +3 -1
  123. package/dist/agent-core/tools/runtime.js +22 -7
  124. package/dist/agent-core/tools/scheduler.d.ts +2 -0
  125. package/dist/agent-core/tools/scheduler.js +43 -6
  126. package/dist/index.d.ts +21 -0
  127. package/dist/sandbox/linux/bubblewrap-sandbox-executor.js +5 -2
  128. package/package.json +1 -1
@@ -1,11 +1,26 @@
1
1
  import { MarAgentError } from '../error.js';
2
- import { AGENT_TOOL_HANDLERS } from './registry.js';
3
- export async function executeRegisteredTool(name, arguments_, callId, context) {
4
- const handler = AGENT_TOOL_HANDLERS.get(name);
5
- if (handler)
6
- return handler(arguments_, context, callId);
7
- const call = { name, arguments: arguments_, callId };
8
- if (name.startsWith('mcp__')) {
2
+ import { randomUUID } from 'node:crypto';
3
+ import { AGENT_TOOL_HANDLERS, BUILTIN_TOOL_DEFINITIONS } from './registry.js';
4
+ import { normalizeToolInput } from './input.js';
5
+ import { validateToolResult } from './output-projection.js';
6
+ export async function executeRegisteredTool(name, arguments_, callId, context, caller = 'direct') {
7
+ if (context.invokeTool)
8
+ return validateToolResult(await context.invokeTool({ name, arguments: arguments_, callId }, context, caller));
9
+ return validateToolResult(await executeCapturedTool(AGENT_TOOL_HANDLERS.has(name) ? 'builtin' : name.startsWith('mcp__') ? 'mcp' : 'host', { name, arguments: arguments_, callId }, context));
10
+ }
11
+ /** Invoke an already captured source; names never reselect a different backend. */
12
+ export async function executeCapturedTool(kind, call, context) {
13
+ const definition = kind === 'builtin'
14
+ ? BUILTIN_TOOL_DEFINITIONS.find((tool) => tool.name === call.name)
15
+ : undefined;
16
+ if (definition)
17
+ call = { ...call, arguments: normalizeToolInput(call.arguments, definition.inputSchema) };
18
+ if (kind === 'builtin') {
19
+ const handler = AGENT_TOOL_HANDLERS.get(call.name);
20
+ if (handler)
21
+ return handler(call.arguments, context, call.callId ?? randomUUID());
22
+ }
23
+ if (kind === 'mcp') {
9
24
  if (!context.host.callMcpTool)
10
25
  throw new MarAgentError('MAR_AGENT_MCP_FAILED', 'MCP execution is unavailable.');
11
26
  return context.host.callMcpTool(call, context.signal, {
@@ -1,4 +1,6 @@
1
1
  import type { ClientToolDefinition } from '../model/contracts.js';
2
+ /** A managed independent callback must not borrow its still-active creator's tool barrier. */
3
+ export declare function withIndependentSessionTools<Value>(run: () => Value): Value;
2
4
  /** One barrier domain for foreground tools and all retained cells in a Session. */
3
5
  export declare function createSessionToolScheduler(): <T>(definition: ClientToolDefinition | undefined, run: () => Promise<T>) => Promise<T>;
4
6
  /** Schedules an incremental stream while preserving the same safe/serial barriers as batches. */
@@ -1,13 +1,50 @@
1
+ import { AsyncLocalStorage } from 'node:async_hooks';
2
+ const sessionToolIngress = new AsyncLocalStorage();
3
+ /** A managed independent callback must not borrow its still-active creator's tool barrier. */
4
+ export function withIndependentSessionTools(run) {
5
+ return sessionToolIngress.run(Symbol(), run);
6
+ }
1
7
  /** One barrier domain for foreground tools and all retained cells in a Session. */
2
8
  export function createSessionToolScheduler() {
3
- const schedule = createToolCallScheduler([
9
+ const leases = new AsyncLocalStorage();
10
+ const definitions = [
4
11
  { name: 'safe', parallelSafety: 'safe' },
5
12
  { name: 'serial', parallelSafety: 'serial' }
6
- ], (job) => job.run());
7
- return (definition, run) => schedule({
8
- name: definition?.parallelSafety === 'safe' ? 'safe' : 'serial',
9
- run
10
- });
13
+ ];
14
+ const execute = async (job) => {
15
+ const lease = {
16
+ active: true,
17
+ ingress: sessionToolIngress.getStore(),
18
+ schedule: createToolCallScheduler(definitions, execute),
19
+ children: new Set()
20
+ };
21
+ return leases.run(lease, async () => {
22
+ try {
23
+ return await job.run();
24
+ }
25
+ finally {
26
+ // The parent keeps its barrier until every accepted descendant has settled.
27
+ while (lease.children.size)
28
+ await Promise.all([...lease.children]);
29
+ lease.active = false;
30
+ }
31
+ });
32
+ };
33
+ const root = createToolCallScheduler(definitions, execute);
34
+ return (definition, run) => {
35
+ const inherited = leases.getStore();
36
+ const parent = inherited?.ingress === sessionToolIngress.getStore() ? inherited : undefined;
37
+ const result = (parent?.active ? parent.schedule : root)({
38
+ name: definition?.parallelSafety === 'safe' ? 'safe' : 'serial',
39
+ run
40
+ });
41
+ if (parent?.active) {
42
+ const settled = result.then(() => undefined, () => undefined);
43
+ parent.children.add(settled);
44
+ void settled.then(() => parent.children.delete(settled));
45
+ }
46
+ return result;
47
+ };
11
48
  }
12
49
  /** Schedules an incremental stream while preserving the same safe/serial barriers as batches. */
13
50
  export function createToolCallScheduler(definitions, execute) {
package/dist/index.d.ts CHANGED
@@ -8,7 +8,28 @@ export { testMarAgentModelTransport } from './agent-core/model/transport-test.js
8
8
  export type { AccessMode, ExecutionMode, ExecutionResult, MarAgentImageMetadata, RolloutBudgetOptions, RunInput, RunInputImage } from './agent-core/runtime/contracts.js';
9
9
  export type { MarAgentEvent } from './agent-core/runtime/events.js';
10
10
  export { createMarAgent } from './agent-core/sdk/agent.js';
11
+ export type { CoreAgentExtensionContext, CoreSessionExtensionContext, CoreRuntimeExtension, CoreExtensionSnapshot, CoreExtensionSource, CoreExtensionDiagnostic, CoreDomainOperations, CoreDomainFacts, CoreHookRegistrar, CoreCapabilitySnapshot, CoreCommandSpec, CorePromptSection, CoreServiceDeclaration, CoreServiceDependency } from './agent-core/extensions/contracts.js';
12
+ export type { CoreDisposer, CoreResourceRegistration, CoreResourceScope } from './agent-core/extensions/resources.js';
13
+ export type { CoreHookOptions, CoreInterceptor } from './agent-core/extensions/hooks.js';
14
+ export type { CoreOperationContext } from './agent-core/extensions/operation.js';
15
+ export type { CoreServiceKey, CoreServiceRegistry } from './agent-core/extensions/services.js';
16
+ export type { CoreToolSpec, CoreToolRef, CoreToolInvocation, CoreToolCheck, CoreToolAttempt, CoreToolCompletion, CoreToolFailure } from './agent-core/extensions/tools.js';
17
+ export type { CoreModelMessage, CoreModelRequest, CoreRequestSnapshot } from './agent-core/extensions/model-request.js';
18
+ export type { CoreModelEvent } from './agent-core/extensions/model-stream.js';
19
+ export type { CorePromptPart, CorePromptFacts, CorePromptComposition, CorePromptSectionInput } from './agent-core/extensions/prompt-composition.js';
20
+ export type { CoreFilesApi, CoreFilesBackend, CoreFilePath, CoreFileWrite, CoreFileRemove, CoreFileTransfer, CoreFileType, CoreFileInfo, CoreFileEntry, CoreFileCompletion } from './agent-core/extensions/files.js';
21
+ export type { CoreHostExtensionPorts, CoreHostToolSource, CoreHostToolsBackend } from './agent-core/host/contracts.js';
22
+ export type { CoreEnvironmentApi, CoreEnvironmentBackend, CoreEnvironmentKey, CoreEnvironmentSet, CoreEnvironmentChange, CoreEnvironmentCompletion } from './agent-core/extensions/environment.js';
23
+ export type { CoreMcpApi, CoreMcpBackend, CoreMcpConnectionBackend, CoreMcpToolCall, CoreMcpServerDefinition, CoreMcpServerRef, CoreMcpServerRegistration, CoreMcpConnectionRef, CoreMcpConnectInput, CoreMcpConnectionInput, CoreMcpCallInput, CoreMcpCatalog, CoreMcpCompletion } from './agent-core/extensions/mcp.js';
24
+ export type { CoreAgentsApi, CoreAgentsBackend, CoreAgentSpawnInput, CoreAgentTarget, CoreAgentWaitInput, CoreAgentMessageInput, CoreAgentSnapshot, CoreAgentHandledResult, CoreAgentSpawnResult, CoreAgentCompletion } from './agent-core/extensions/agents.js';
25
+ export type { CoreSettingsApi, CoreSettingsBackend, CoreSettingsReadInput, CoreSettingsUpdate, CoreSettingsDescription, CoreSettingDefinition, CoreSettingsSnapshot, CoreSettingsResult, CoreSettingsCompletion } from './agent-core/extensions/settings.js';
26
+ export type { CoreNetworkApi, CoreNetworkBackend, CoreHttpRequest, CoreHttpResponse, CoreHttpCompletion } from './agent-core/extensions/network.js';
27
+ export type { CoreSessionApi, CoreSessionReceipt, CoreSessionInspection, CoreSessionDescription, CoreSessionMessages, CoreSessionMessagesInput, CoreSessionMessage, CoreSessionOperationStatus, CoreAppendInput, CoreSubmitInput, CoreInputSource, CoreCompactInput, CoreSessionActionResult } from './agent-core/extensions/session-input.js';
28
+ export type { CorePromptInput, CorePromptResult } from './agent-core/extensions/prompt-input.js';
29
+ export type { CoreModelsApi, CoreModelDescription, CoreModelTextBlock, CoreGenerateInput, CoreGenerateResult } from './agent-core/extensions/models.js';
30
+ export type { CoreDataApi, CoreJsonValue, CoreCheckpoint, CoreCheckpointApi, CoreStateApi, CoreStateChange, CoreStoreApi, CoreStoreCommit } from './agent-core/extensions/data.js';
11
31
  export { generateSessionTitle, type GenerateSessionTitleInput } from './shared/auto-title.js';
32
+ export type { CoreProcessesApi, CoreProcessesBackend, CoreProcessInput, CoreProcessRunInput, CoreProcessHandle, CoreProcessExit, CoreProcessResult, CoreProcessCompletion } from './agent-core/extensions/processes.js';
12
33
  export type { CreateMarAgentOptions, CreateSessionInput, ExecutionHandle, MarAgent, MarAgentSession, SessionTitleUpdateInput } from './agent-core/sdk/types.js';
13
34
  export { openMarAgentSessionCatalog, type MarAgentContextUsage, type MarAgentHistoryEntry, type MarAgentHistoryPage, type MarAgentSessionCatalog, type MarAgentSessionDeleteResult, type MarAgentSessionImage, type MarAgentSessionPage, type MarAgentSessionSummary } from './agent-core/session/catalog.js';
14
35
  export type { SessionListInput, SessionSource } from './agent-core/session/types.js';
@@ -98,6 +98,7 @@ export class BubblewrapSandboxExecutor {
98
98
  return child;
99
99
  }
100
100
  catch (error) {
101
+ request.signal?.throwIfAborted();
101
102
  throw unavailable(error);
102
103
  }
103
104
  }
@@ -202,9 +203,11 @@ export class BubblewrapSandboxExecutor {
202
203
  args.push(mount.access === 'READ_WRITE' ? '--bind' : '--ro-bind', mount.source, mount.destination);
203
204
  if (request.owner !== undefined) {
204
205
  if (!CURSOR_SAFE_ID.test(request.owner.sessionId) ||
205
- !CURSOR_SAFE_ID.test(request.owner.executionId))
206
+ (request.owner.executionId !== undefined && !CURSOR_SAFE_ID.test(request.owner.executionId)))
206
207
  throw policyInvalid();
207
- args.push('--setenv', 'MAR_AGENT_SESSION_ID', request.owner.sessionId, '--setenv', 'MAR_AGENT_EXECUTION_ID', request.owner.executionId);
208
+ args.push('--setenv', 'MAR_AGENT_SESSION_ID', request.owner.sessionId);
209
+ if (request.owner.executionId !== undefined)
210
+ args.push('--setenv', 'MAR_AGENT_EXECUTION_ID', request.owner.executionId);
208
211
  }
209
212
  for (const [name, value] of explicitEnvironment(request))
210
213
  args.push('--setenv', name, value);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@myagentroam/agent",
3
- "version": "0.9.159",
3
+ "version": "0.9.160",
4
4
  "description": "Embeddable MAR coding agent SDK and CLI.",
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",