@archships/dim-agent-sdk 0.0.1 → 0.0.3

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 (95) hide show
  1. package/README.md +115 -4
  2. package/dist/{agent-core → dim-agent-sdk/src/agent-core}/Agent.d.ts +7 -1
  3. package/dist/{agent-core → dim-agent-sdk/src/agent-core}/LoopRunner.d.ts +6 -0
  4. package/dist/{agent-core → dim-agent-sdk/src/agent-core}/Session.d.ts +26 -1
  5. package/dist/{agent-core → dim-agent-sdk/src/agent-core}/ToolExecutor.d.ts +11 -1
  6. package/dist/{agent-core → dim-agent-sdk/src/agent-core}/agent-types.d.ts +5 -2
  7. package/dist/dim-agent-sdk/src/agent-core/approvals.d.ts +25 -0
  8. package/dist/dim-agent-sdk/src/agent-core/compaction.d.ts +22 -0
  9. package/dist/{agent-core → dim-agent-sdk/src/agent-core}/errors.d.ts +1 -0
  10. package/dist/{agent-core → dim-agent-sdk/src/agent-core}/index.d.ts +7 -0
  11. package/dist/dim-agent-sdk/src/agent-core/notifications.d.ts +25 -0
  12. package/dist/dim-agent-sdk/src/agent-core/plugin-state.d.ts +24 -0
  13. package/dist/{agent-core → dim-agent-sdk/src/agent-core}/session-state.d.ts +4 -1
  14. package/dist/dim-agent-sdk/src/agent-core/session-status.d.ts +4 -0
  15. package/dist/dim-agent-sdk/src/agent-core/subagent.d.ts +14 -0
  16. package/dist/dim-agent-sdk/src/context/compaction.d.ts +1 -0
  17. package/dist/dim-agent-sdk/src/context/index.d.ts +4 -0
  18. package/dist/dim-agent-sdk/src/contracts/compaction.d.ts +52 -0
  19. package/dist/{contracts → dim-agent-sdk/src/contracts}/event.d.ts +8 -1
  20. package/dist/{contracts → dim-agent-sdk/src/contracts}/index.d.ts +2 -0
  21. package/dist/dim-agent-sdk/src/contracts/plugin-state.d.ts +11 -0
  22. package/dist/dim-agent-sdk/src/contracts/state.d.ts +29 -0
  23. package/dist/{contracts → dim-agent-sdk/src/contracts}/tool.d.ts +6 -0
  24. package/dist/{index.d.ts → dim-agent-sdk/src/index.d.ts} +2 -1
  25. package/dist/{persistence → dim-agent-sdk/src/persistence}/SnapshotCodec.d.ts +3 -1
  26. package/dist/dim-agent-sdk/src/plugin-host/HookPipeline.d.ts +30 -0
  27. package/dist/dim-agent-sdk/src/plugin-host/PluginHost.d.ts +58 -0
  28. package/dist/dim-agent-sdk/src/plugin-host/helpers.d.ts +6 -0
  29. package/dist/dim-agent-sdk/src/plugin-host/index.d.ts +4 -0
  30. package/dist/dim-agent-sdk/src/plugin-host/types.d.ts +1 -0
  31. package/dist/{services → dim-agent-sdk/src/services}/PermissionGateway.d.ts +3 -0
  32. package/dist/{services → dim-agent-sdk/src/services}/types.d.ts +3 -1
  33. package/dist/dim-plugin-api/src/index.d.ts +602 -0
  34. package/dist/index.js +1194 -166
  35. package/package.json +12 -12
  36. package/dist/context/index.d.ts +0 -3
  37. package/dist/contracts/state.d.ts +0 -14
  38. package/dist/plugin-host/HookPipeline.d.ts +0 -7
  39. package/dist/plugin-host/PluginHost.d.ts +0 -36
  40. package/dist/plugin-host/helpers.d.ts +0 -3
  41. package/dist/plugin-host/index.d.ts +0 -4
  42. package/dist/plugin-host/types.d.ts +0 -1
  43. /package/dist/{agent-core → dim-agent-sdk/src/agent-core}/MessageFactory.d.ts +0 -0
  44. /package/dist/{agent-core → dim-agent-sdk/src/agent-core}/ModelTurnCollector.d.ts +0 -0
  45. /package/dist/{agent-core → dim-agent-sdk/src/agent-core}/TerminationPolicy.d.ts +0 -0
  46. /package/dist/{agent-core → dim-agent-sdk/src/agent-core}/createModel.d.ts +0 -0
  47. /package/dist/{agent-core → dim-agent-sdk/src/agent-core}/tool-call.d.ts +0 -0
  48. /package/dist/{context → dim-agent-sdk/src/context}/AutoContextManager.d.ts +0 -0
  49. /package/dist/{context → dim-agent-sdk/src/context}/types.d.ts +0 -0
  50. /package/dist/{contracts → dim-agent-sdk/src/contracts}/common.d.ts +0 -0
  51. /package/dist/{contracts → dim-agent-sdk/src/contracts}/content-normalize.d.ts +0 -0
  52. /package/dist/{contracts → dim-agent-sdk/src/contracts}/content.d.ts +0 -0
  53. /package/dist/{contracts → dim-agent-sdk/src/contracts}/message.d.ts +0 -0
  54. /package/dist/{contracts → dim-agent-sdk/src/contracts}/model.d.ts +0 -0
  55. /package/dist/{contracts → dim-agent-sdk/src/contracts}/tool-normalize.d.ts +0 -0
  56. /package/dist/{persistence → dim-agent-sdk/src/persistence}/FileStateStore.d.ts +0 -0
  57. /package/dist/{persistence → dim-agent-sdk/src/persistence}/InMemoryStateStore.d.ts +0 -0
  58. /package/dist/{persistence → dim-agent-sdk/src/persistence}/index.d.ts +0 -0
  59. /package/dist/{persistence → dim-agent-sdk/src/persistence}/store.d.ts +0 -0
  60. /package/dist/{providers → dim-agent-sdk/src/providers}/anthropic/adapter.d.ts +0 -0
  61. /package/dist/{providers → dim-agent-sdk/src/providers}/anthropic/mapper.d.ts +0 -0
  62. /package/dist/{providers → dim-agent-sdk/src/providers}/gemini/adapter.d.ts +0 -0
  63. /package/dist/{providers → dim-agent-sdk/src/providers}/gemini/mapper.d.ts +0 -0
  64. /package/dist/{providers → dim-agent-sdk/src/providers}/index.d.ts +0 -0
  65. /package/dist/{providers → dim-agent-sdk/src/providers}/openai/adapter.d.ts +0 -0
  66. /package/dist/{providers → dim-agent-sdk/src/providers}/openai/mapper.d.ts +0 -0
  67. /package/dist/{providers → dim-agent-sdk/src/providers}/openai-responses/adapter.d.ts +0 -0
  68. /package/dist/{providers → dim-agent-sdk/src/providers}/openai-responses/mapper.d.ts +0 -0
  69. /package/dist/{providers → dim-agent-sdk/src/providers}/shared/http-error.d.ts +0 -0
  70. /package/dist/{providers → dim-agent-sdk/src/providers}/shared/provider-state.d.ts +0 -0
  71. /package/dist/{providers → dim-agent-sdk/src/providers}/shared/reasoning.d.ts +0 -0
  72. /package/dist/{providers → dim-agent-sdk/src/providers}/shared/tool-call.d.ts +0 -0
  73. /package/dist/{providers → dim-agent-sdk/src/providers}/shared/usage.d.ts +0 -0
  74. /package/dist/{services → dim-agent-sdk/src/services}/ExecGateway.d.ts +0 -0
  75. /package/dist/{services → dim-agent-sdk/src/services}/FileSystemGateway.d.ts +0 -0
  76. /package/dist/{services → dim-agent-sdk/src/services}/GitGateway.d.ts +0 -0
  77. /package/dist/{services → dim-agent-sdk/src/services}/ModelGateway.d.ts +0 -0
  78. /package/dist/{services → dim-agent-sdk/src/services}/NetworkGateway.d.ts +0 -0
  79. /package/dist/{services → dim-agent-sdk/src/services}/activity.d.ts +0 -0
  80. /package/dist/{services → dim-agent-sdk/src/services}/index.d.ts +0 -0
  81. /package/dist/{services → dim-agent-sdk/src/services}/permissions.d.ts +0 -0
  82. /package/dist/{tools → dim-agent-sdk/src/tools}/BaseTool.d.ts +0 -0
  83. /package/dist/{tools → dim-agent-sdk/src/tools}/ToolRegistry.d.ts +0 -0
  84. /package/dist/{tools → dim-agent-sdk/src/tools}/builtins/EditTool.d.ts +0 -0
  85. /package/dist/{tools → dim-agent-sdk/src/tools}/builtins/ExecTool.d.ts +0 -0
  86. /package/dist/{tools → dim-agent-sdk/src/tools}/builtins/ReadTool.d.ts +0 -0
  87. /package/dist/{tools → dim-agent-sdk/src/tools}/builtins/WriteTool.d.ts +0 -0
  88. /package/dist/{tools → dim-agent-sdk/src/tools}/builtins/index.d.ts +0 -0
  89. /package/dist/{tools → dim-agent-sdk/src/tools}/builtins/utils.d.ts +0 -0
  90. /package/dist/{tools → dim-agent-sdk/src/tools}/index.d.ts +0 -0
  91. /package/dist/{tools → dim-agent-sdk/src/tools}/result.d.ts +0 -0
  92. /package/dist/{utils → dim-agent-sdk/src/utils}/guards.d.ts +0 -0
  93. /package/dist/{utils → dim-agent-sdk/src/utils}/id.d.ts +0 -0
  94. /package/dist/{utils → dim-agent-sdk/src/utils}/json.d.ts +0 -0
  95. /package/dist/{utils → dim-agent-sdk/src/utils}/usage.d.ts +0 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@archships/dim-agent-sdk",
3
- "version": "0.0.1",
3
+ "version": "0.0.3",
4
4
  "description": "An agent-first TypeScript SDK with provider adapters, sessions, hooks, plugins, and runtime gateways.",
5
5
  "type": "module",
6
6
  "exports": {
@@ -19,24 +19,24 @@
19
19
  "node": ">=18"
20
20
  },
21
21
  "scripts": {
22
- "build": "rm -rf dist && bun build ./src/index.ts --outdir dist --target node --format esm && tsc --project tsconfig.build.json",
23
- "typecheck": "tsc --noEmit",
22
+ "build": "rm -rf dist && bun build ./src/index.ts --outdir dist --target node --format esm && bun x tsc --project tsconfig.build.json",
23
+ "typecheck": "bun x tsc --noEmit",
24
24
  "test": "bun test",
25
+ "test:e2e": "bun test test/e2e",
26
+ "test:smoke": "bun test ./test/smoke/provider-tools.smoke.ts ./test/smoke/provider-hooks.smoke.ts ./test/smoke/provider-plan-mode.smoke.ts",
27
+ "test:plugins": "bun test test/plugin-integration.test.ts test/auto-compact-plugin.test.ts test/plan-mode-plugin.test.ts test/plugin-catalog.test.ts",
25
28
  "prepack": "bun run build",
29
+ "demo:auto-compact": "bun run demo/auto-compact-plugin.ts",
30
+ "demo:compaction": "bun run demo/compaction-scripted.ts",
31
+ "demo:plan-mode": "bun run demo/plan-mode-plugin.ts",
26
32
  "demo:openai": "bun run demo/openai-tools.ts",
33
+ "demo:hooks": "bun run demo/openai-hooks.ts",
27
34
  "bump": "bumpp --commit --no-verify --no-tag --no-push",
28
35
  "release": "bun run bump && bun run build && bun publish",
29
36
  "release:check": "bun run build && npm pack --dry-run"
30
37
  },
31
38
  "license": "UNLICENSED",
32
- "repository": {
33
- "type": "git",
34
- "url": "git+ssh://git@gitlab.bfbops.com/nextim/dim-sdk.git"
35
- },
36
- "homepage": "https://gitlab.bfbops.com/nextim/dim-sdk",
37
- "bugs": {
38
- "url": "https://gitlab.bfbops.com/nextim/dim-sdk/-/issues"
39
- },
39
+ "homepage": "https://dimcode.dev/",
40
40
  "keywords": [
41
41
  "agent",
42
42
  "sdk",
@@ -49,6 +49,6 @@
49
49
  "access": "public"
50
50
  },
51
51
  "dependencies": {
52
- "@archships/dim-plugin-api": "^0.0.1"
52
+ "@archships/dim-plugin-api": "^0.0.2"
53
53
  }
54
54
  }
@@ -1,3 +0,0 @@
1
- export { AutoContextManager } from './AutoContextManager';
2
- export type { AutoContextManagerOptions } from './AutoContextManager';
3
- export type { ContextItem, ContextManager, ContextResolveOptions } from './types';
@@ -1,14 +0,0 @@
1
- import type { Usage } from './common';
2
- import type { Message } from './message';
3
- import type { ModelRef } from './model';
4
- export interface SessionSnapshot {
5
- schemaVersion: 1;
6
- sessionId: string;
7
- model?: ModelRef;
8
- cwd?: string;
9
- messages: Message[];
10
- usage?: Usage;
11
- createdAt: number;
12
- updatedAt: number;
13
- metadata?: Record<string, unknown>;
14
- }
@@ -1,7 +0,0 @@
1
- import type { HookName, HookPayloadMap, HookRegistration, PluginRuntimeContext } from './types';
2
- export declare class HookPipeline {
3
- private readonly registrations;
4
- register(pluginId: string, priority: number, hooks?: HookRegistration): void;
5
- runMiddleware<N extends HookName>(name: N, payload: HookPayloadMap[N], context: PluginRuntimeContext): Promise<HookPayloadMap[N]>;
6
- runObservers<N extends HookName>(name: N, payload: HookPayloadMap[N], context: PluginRuntimeContext): Promise<void>;
7
- }
@@ -1,36 +0,0 @@
1
- import type { ContextItem } from '../context';
2
- import { PermissionGateway } from '../services';
3
- import type { ActivityTracker, AgentServices } from '../services';
4
- import type { Tool } from '../contracts';
5
- import { HookPipeline } from './HookPipeline';
6
- import type { ContextContributorInput, DimPlugin, PluginRuntimeContext, PromptContributorInput } from './types';
7
- export interface PluginHostOptions {
8
- agentId: string;
9
- cwd?: string;
10
- plugins?: DimPlugin[];
11
- services: AgentServices;
12
- permissionGateway: PermissionGateway;
13
- tracker?: ActivityTracker;
14
- }
15
- export declare class PluginHost {
16
- readonly pipeline: HookPipeline;
17
- private readonly contextContributors;
18
- private readonly promptContributors;
19
- private readonly tools;
20
- private readonly services;
21
- private readonly cwd?;
22
- private readonly agentId;
23
- private readonly tracker?;
24
- constructor(options: PluginHostOptions);
25
- pluginTools(): Tool[];
26
- recentFiles(limit?: number): string[];
27
- runMiddleware<N extends keyof import('./types').HookPayloadMap>(name: N, payload: import('./types').HookPayloadMap[N], context?: Omit<PluginRuntimeContext, 'agentId' | 'services'> & {
28
- services?: AgentServices;
29
- }): Promise<import('./types').HookPayloadMap[N]>;
30
- runObservers<N extends keyof import('./types').HookPayloadMap>(name: N, payload: import('./types').HookPayloadMap[N], context?: Omit<PluginRuntimeContext, 'agentId' | 'services'> & {
31
- services?: AgentServices;
32
- }): Promise<void>;
33
- collectContext(input: ContextContributorInput): Promise<ContextItem[]>;
34
- collectPromptSegments(input: PromptContributorInput): Promise<string[]>;
35
- private createRuntimeContext;
36
- }
@@ -1,3 +0,0 @@
1
- import type { HookControlResult } from '@archships/dim-plugin-api';
2
- export { continueHook, replaceHook, stopHook } from '@archships/dim-plugin-api';
3
- export declare function isHookControlResult<T>(value: unknown): value is HookControlResult<T>;
@@ -1,4 +0,0 @@
1
- export { continueHook, replaceHook, stopHook } from './helpers';
2
- export { HookPipeline } from './HookPipeline';
3
- export { PluginHost } from './PluginHost';
4
- export type { AgentMode, ContextContributor, ContextContributorInput, DimPlugin, HookControlResult, HookHandler, HookMiddleware, HookName, HookObserver, HookPayloadMap, HookRegistration, PluginContext, PluginManifest, PluginRuntimeContext, PluginSetupResult, PromptContributor, PromptContributorInput, } from './types';
@@ -1 +0,0 @@
1
- export type { AgentMode, CallToolResult, ContextContributor, ContextContributorInput, ContextItem, DimPlugin, HookControlResult, HookHandler, HookMiddleware, HookName, HookObserver, HookPayloadMap, HookRegistration, PermissionSpec, PluginContext, PluginManifest, PluginRuntimeContext, PluginServices, PluginSetupResult, PromptContributor, PromptContributorInput, Tool, ToolCall, ToolDefinition, } from '@archships/dim-plugin-api';
File without changes