@archships/dim-agent-sdk 0.0.1 → 0.0.2

package/dist/{index.d.ts → dim-agent-sdk/src/index.d.ts}

@@ -1,7 +1,8 @@
-export type { CallToolResult, ContentBlock, Message, MessageContentInput, ModelAdapter, ModelClient, ModelRequest, ModelStreamEvent, ModelStopReason, ModelRef, SessionSnapshot, SessionStreamEvent, Tool, ToolCall, ToolDefinition, ToolExecutionContext, ToolInputSchema, Usage, } from './contracts';
+export type { CallToolResult, CompactionBudgetInfo, CompactionCheckpoint, CompactionEstimator, CompactionEstimatorInput, CompactionOptions, CompactionService, CompactionState, CompactionTriggerReason, CompactionUpdate, ContentBlock, Message, MessageContentInput, ModelAdapter, ModelClient, ModelRequest, ModelStreamEvent, ModelStopReason, ModelRef, PluginSessionStateEntry, PluginStateService, SessionStatus, SessionPluginEvent, SessionSnapshot, SessionStreamEvent, Tool, ToolCall, ToolDefinition, ToolExecutionContext, ToolExecutionPluginEvent, ToolInputSchema, Usage, } from './contracts';
 export { normalizeContent } from './contracts/content-normalize';
 export { Agent, createAgent } from './agent-core/Agent';
 export type { CreateAgentOptions } from './agent-core/Agent';
+export { DefaultCompactionService } from './agent-core/compaction';
 export { Session } from './agent-core/Session';
 export { SessionExecutionError } from './agent-core/errors';
 export { FileStateStore, InMemoryStateStore } from './persistence';

package/dist/{persistence → dim-agent-sdk/src/persistence}/SnapshotCodec.d.ts

@@ -1,10 +1,12 @@
-import type { Message, ModelRef, SessionSnapshot, Usage } from '../contracts';
+import type { CompactionState, Message, ModelRef, PluginSessionStateEntry, SessionSnapshot, Usage } from '../contracts';
 export interface SnapshotCodecInput {
     sessionId: string;
     model?: ModelRef;
     cwd?: string;
     messages: Message[];
     usage?: Usage;
+    compaction?: CompactionState;
+    pluginState?: Record<string, PluginSessionStateEntry>;
     createdAt: number;
     updatedAt: number;
     metadata?: Record<string, unknown>;

package/dist/dim-agent-sdk/src/plugin-host/HookPipeline.d.ts

@@ -0,0 +1,30 @@
+import type { HookName, HookPayloadMap, HookRegistration, NotificationHookPayload, PluginRuntimeContext, RunStopControlResult, RunStopPayload, ToolBeforeExecuteControlResult, ToolBeforeExecutePayload } from './types';
+type SpecialHookName = 'notify.message' | 'run.stop' | 'tool.beforeExecute';
+type StandardHookName = Exclude<HookName, SpecialHookName>;
+export interface ToolBeforeExecuteHookResult {
+    payload: ToolBeforeExecutePayload;
+    control?: ToolBeforeExecuteControlResult;
+}
+export interface NotifyMessageHookResult {
+    payload: NotificationHookPayload;
+    suppressed?: boolean;
+}
+export interface RunStopHookResult {
+    payload: RunStopPayload;
+    control?: RunStopControlResult;
+}
+export declare class HookPipeline {
+    private readonly registrations;
+    private nextOrder;
+    register(pluginId: string, pluginPriority: number, hooks?: HookRegistration, services?: PluginRuntimeContext['services']): void;
+    runMiddleware<N extends StandardHookName>(name: N, payload: HookPayloadMap[N], context: PluginRuntimeContext): Promise<HookPayloadMap[N]>;
+    runToolBeforeExecute(payload: ToolBeforeExecutePayload, context: PluginRuntimeContext): Promise<ToolBeforeExecuteHookResult>;
+    runNotifyMessage(payload: NotificationHookPayload, context: PluginRuntimeContext): Promise<NotifyMessageHookResult>;
+    runRunStop(payload: RunStopPayload, context: PluginRuntimeContext): Promise<RunStopHookResult>;
+    runObservers<N extends HookName>(name: N, payload: HookPayloadMap[N], context: PluginRuntimeContext): Promise<void>;
+    private matchingRegistrations;
+    private runMiddlewareHandler;
+    private runObserverHandler;
+    private withHandlerMetadata;
+}
+export {};

package/dist/dim-agent-sdk/src/plugin-host/PluginHost.d.ts

@@ -0,0 +1,58 @@
+import type { ContextItem } from '../context';
+import type { SessionStatus } from '../contracts';
+import { PermissionGateway } from '../services';
+import type { ActivityTracker, AgentServices } from '../services';
+import type { Tool } from '../contracts';
+import { HookPipeline } from './HookPipeline';
+import type { ContextContributorInput, DimPlugin, HookName, HookPayloadMap, PluginRuntimeContext, PromptContributorInput, RunStopPayload, ToolBeforeExecutePayload } from './types';
+type SpecialHookName = 'notify.message' | 'run.stop' | 'tool.beforeExecute';
+type StandardHookName = Exclude<HookName, SpecialHookName>;
+export interface SessionControllerContextInput {
+    sessionId: string;
+    metadata?: Record<string, unknown>;
+    getStatus(): SessionStatus;
+    save(): Promise<void>;
+    isRunning(): boolean;
+}
+export interface PluginHostOptions {
+    agentId: string;
+    cwd?: string;
+    plugins?: DimPlugin[];
+    services: AgentServices;
+    permissionGateway: PermissionGateway;
+    tracker?: ActivityTracker;
+}
+export declare class PluginHost {
+    readonly pipeline: HookPipeline;
+    private readonly contextContributors;
+    private readonly promptContributors;
+    private readonly tools;
+    private readonly sessionControllerFactories;
+    private readonly services;
+    private readonly cwd?;
+    private readonly agentId;
+    private readonly tracker?;
+    constructor(options: PluginHostOptions);
+    pluginTools(): Tool[];
+    recentFiles(limit?: number): string[];
+    createSessionControllers(input: SessionControllerContextInput): Map<string, unknown>;
+    runMiddleware<N extends StandardHookName>(name: N, payload: HookPayloadMap[N], context?: Omit<PluginRuntimeContext, 'agentId' | 'services'> & {
+        services?: AgentServices;
+    }): Promise<HookPayloadMap[N]>;
+    runToolBeforeExecute(payload: ToolBeforeExecutePayload, context?: Omit<PluginRuntimeContext, 'agentId' | 'services'> & {
+        services?: AgentServices;
+    }): Promise<import("./HookPipeline").ToolBeforeExecuteHookResult>;
+    runNotifyMessage(payload: HookPayloadMap['notify.message'], context?: Omit<PluginRuntimeContext, 'agentId' | 'services'> & {
+        services?: AgentServices;
+    }): Promise<import("./HookPipeline").NotifyMessageHookResult>;
+    runRunStop(payload: RunStopPayload, context?: Omit<PluginRuntimeContext, 'agentId' | 'services'> & {
+        services?: AgentServices;
+    }): Promise<import("./HookPipeline").RunStopHookResult>;
+    runObservers<N extends HookName>(name: N, payload: HookPayloadMap[N], context?: Omit<PluginRuntimeContext, 'agentId' | 'services'> & {
+        services?: AgentServices;
+    }): Promise<void>;
+    collectContext(input: ContextContributorInput): Promise<ContextItem[]>;
+    collectPromptSegments(input: PromptContributorInput): Promise<string[]>;
+    private createRuntimeContext;
+}
+export {};

package/dist/dim-agent-sdk/src/plugin-host/helpers.d.ts

@@ -0,0 +1,6 @@
+import type { HookControlResult, NotificationControlResult, RunStopControlResult, ToolBeforeExecuteControlResult } from '@archships/dim-plugin-api';
+export { allowToolCall, askToolCall, continueHook, continueNotification, continueRun, denyToolCall, finalizeRun, provideToolResult, replaceHook, replaceNotification, replaceToolCall, stopHook, suppressNotification, } from '@archships/dim-plugin-api';
+export declare function isHookControlResult<T>(value: unknown): value is HookControlResult<T>;
+export declare function isToolBeforeExecuteControlResult(value: unknown): value is ToolBeforeExecuteControlResult;
+export declare function isNotificationControlResult(value: unknown): value is NotificationControlResult;
+export declare function isRunStopControlResult(value: unknown): value is RunStopControlResult;

package/dist/dim-agent-sdk/src/plugin-host/index.d.ts

@@ -0,0 +1,4 @@
+export { allowToolCall, askToolCall, continueHook, continueNotification, continueRun, denyToolCall, finalizeRun, provideToolResult, replaceHook, replaceNotification, replaceToolCall, stopHook, suppressNotification, } from './helpers';
+export { HookPipeline } from './HookPipeline';
+export { PluginHost } from './PluginHost';
+export type { AgentMode, AnyHookRegistrationEntry, ApprovalDecision, ApprovalRequest, AskApprovalInput, ContextCompactBeforePayload, ContextContributor, ContextContributorInput, ContextItem, DimPlugin, HookControlResult, HookDescriptor, HookHandler, HookMatcher, HookMiddleware, HookMiddlewareResult, HookMode, HookName, HookObserver, HookPayloadMap, HookRegistration, HookRegistrationEntry, InternalHookName, NotificationControlResult, NotificationHookPayload, NotificationPayload, PermissionSpec, PluginContext, PluginManifest, PluginRuntimeContext, PluginSessionControllerContext, PluginSessionControllerFactory, PluginSessionStateEntry, PluginStateService, PluginServices, PluginSetupResult, PromptContributor, PromptContributorInput, PublicHookName, RunEndPayload, RunLoopDecision, RunStartPayload, RunStopControlResult, RunStopPayload, SessionStatus, SessionErrorHookPayload, SubagentStopPayload, ToolBeforeExecuteControlResult, } from './types';

package/dist/dim-agent-sdk/src/plugin-host/types.d.ts

@@ -0,0 +1 @@
+export type { AgentMode, AnyHookRegistrationEntry, ApprovalDecision, ApprovalRequest, AskApprovalInput, CallToolResult, ContextCompactBeforePayload, ContextContributor, ContextContributorInput, ContextItem, DimPlugin, HookControlResult, HookDescriptor, HookHandler, HookMatcher, HookMiddleware, HookMiddlewareResult, HookMode, HookName, HookObserver, HookPayloadMap, HookRegistration, HookRegistrationEntry, InternalHookName, NotificationControlResult, NotificationHookPayload, NotificationPayload, PermissionSpec, PluginContext, PluginManifest, PluginRuntimeContext, PluginSessionControllerContext, PluginSessionControllerFactory, PluginSessionStateEntry, PluginStateService, PluginServices, PluginSetupResult, PromptContributor, PromptContributorInput, PublicHookName, RunEndPayload, RunLoopDecision, RunStartPayload, RunStopControlResult, RunStopPayload, SessionStatus, SessionErrorHookPayload, SubagentStopPayload, Tool, ToolBeforeExecuteControlResult, ToolBeforeExecutePayload, ToolCall, ToolDefinition, } from '@archships/dim-plugin-api';

package/dist/{services → dim-agent-sdk/src/services}/PermissionGateway.d.ts

@@ -2,10 +2,13 @@ import type { AgentServices } from './types';
 import type { PermissionSpec } from './permissions';
 export interface PermissionGatewayOptions {
     permissions?: PermissionSpec;
+    compactionOwnerPluginId?: string;
 }
 export declare class PermissionGateway {
     private readonly permissions;
+    private readonly compactionOwnerPluginId?;
     constructor(options?: PermissionGatewayOptions);
     get agentPermissions(): PermissionSpec;
     scopeServices(services: AgentServices, pluginId: string, requested?: PermissionSpec): AgentServices;
+    private ensureCompactionOwner;
 }

package/dist/{services → dim-agent-sdk/src/services}/types.d.ts

@@ -1,4 +1,4 @@
-import type { ModelRequest, ModelStreamEvent } from '../contracts';
+import type { CompactionService, ModelRequest, ModelStreamEvent, PluginStateService } from '../contracts';
 export interface ExecOptions {
     cwd?: string;
     env?: Record<string, string>;
@@ -74,4 +74,6 @@ export interface AgentServices {
     git: GitGateway;
     network: NetworkGateway;
     model: ModelGateway;
+    compaction: CompactionService;
+    pluginState: PluginStateService;
 }