claude-plugin-dsh 0.0.0-stage → 0.1.0

package/dist/src/claude-compat.d.ts

@@ -0,0 +1,8 @@
+export { createPlugin, rootFrom, COMPAT_VERSION, SKILL_RANK } from './plugin.js';
+export type { PluginSpec, RowConfig, Part, DshPlugin } from './plugin.js';
+export * from './plugin-files.js';
+export { runHook, interpretHookResult } from './hooks.js';
+export type { HookRunResult, HookOutcome } from './hooks.js';
+export { TOOL_NAME_MAP, toClaudeTranscript, toClaudeToolInput, toClaudeToolResponse, claudeToolName } from './transcript.js';
+export type * from './dsh-types.js';
+//# sourceMappingURL=claude-compat.d.ts.map

package/dist/src/claude-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-compat.d.ts","sourceRoot":"","sources":["../../src/claude-compat.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAChF,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACzE,cAAc,mBAAmB,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACzD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC5H,mBAAmB,gBAAgB,CAAA"}

package/dist/src/claude-compat.js

@@ -0,0 +1,7 @@
+// Public API. The build bundles this entry into one dependency-free file
+// so existing adapters can keep vendoring dsh/claude-compat.js.
+export { createPlugin, rootFrom, COMPAT_VERSION, SKILL_RANK } from './plugin.js';
+export * from './plugin-files.js';
+export { runHook, interpretHookResult } from './hooks.js';
+export { TOOL_NAME_MAP, toClaudeTranscript, toClaudeToolInput, toClaudeToolResponse, claudeToolName } from './transcript.js';
+//# sourceMappingURL=claude-compat.js.map

package/dist/src/claude-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-compat.js","sourceRoot":"","sources":["../../src/claude-compat.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,gEAAgE;AAChE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEhF,cAAc,mBAAmB,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAEzD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/src/dsh-types.d.ts

@@ -0,0 +1,252 @@
+export interface TextBlock {
+    type: 'text';
+    text: string;
+}
+export interface ToolCallBlock {
+    type: 'tool-call';
+    id: string;
+    name: string;
+    /** Raw JSON string as produced by the model. */
+    arguments: string;
+}
+export type ContentBlock = TextBlock | ToolCallBlock | {
+    type: string;
+};
+export interface MessageSource {
+    kind: string;
+}
+export interface UserMessage {
+    id: string;
+    role: 'user';
+    content: readonly ContentBlock[];
+    source: MessageSource;
+}
+export interface SessionHeader {
+    id: string;
+    cwd?: string;
+    origin?: 'subagent';
+}
+export type SessionEvent = {
+    type: 'user/message';
+    seq?: number;
+    time?: number;
+    data: UserMessage;
+} | {
+    type: 'assistant/message';
+    seq?: number;
+    time?: number;
+    data: {
+        message: {
+            content: readonly ContentBlock[];
+        };
+    };
+} | {
+    type: 'tool/result';
+    seq?: number;
+    time?: number;
+    data: {
+        message: {
+            toolCallId: string;
+            content: readonly ContentBlock[];
+            isError?: boolean;
+        };
+    };
+} | {
+    type: string;
+    seq?: number;
+    time?: number;
+    data?: unknown;
+};
+export interface Session {
+    header: SessionHeader;
+    snapshotEvents?(): readonly SessionEvent[];
+    ownEvents?(): readonly SessionEvent[];
+    events?: readonly SessionEvent[];
+}
+export interface Agent {
+    session: Session;
+    /** Queue context for the next step without waking the agent. */
+    inject(message: UserMessage): void;
+    /** Steering for the nearest step; wakes an idle agent. */
+    steer(message: UserMessage): void;
+    /** A new turn whose only message is this one. */
+    followup(message: UserMessage): void;
+}
+export type PreStepDecision = {
+    kind: 'reject';
+} | {
+    kind: 'enter';
+    messages: UserMessage[];
+    startsRequestSeries?: true;
+};
+export type PreToolDecision = {
+    kind: 'allow';
+} | {
+    kind: 'deny';
+    reason: string;
+} | {
+    kind: 'cancel';
+} | {
+    kind: 'ask';
+    reason?: string;
+    displayReason?: {
+        en: string;
+        [locale: string]: string;
+    };
+};
+export interface ToolExecution {
+    callId: string;
+    name: string;
+    arguments: unknown;
+    agent?: Agent;
+    signal?: AbortSignal;
+}
+export interface ToolExecutionResult {
+    isError: boolean;
+    content?: readonly ContentBlock[];
+}
+export type PostToolDecision = {
+    kind: 'accept';
+    content?: ContentBlock[];
+    value?: never;
+    additionalContexts?: UserMessage[];
+} | {
+    kind: 'accept';
+    value: unknown;
+    content?: never;
+    additionalContexts?: UserMessage[];
+} | {
+    kind: 'block';
+    feedback: ContentBlock[];
+    additionalContexts?: UserMessage[];
+};
+export type SkillSource = 'custom' | (string & {});
+export interface SkillInvocationPolicy {
+    modelInvocable: boolean;
+    userInvocable: boolean;
+}
+export type SkillResourceBase = {
+    kind: 'directory';
+    path: string;
+} | {
+    kind: 'url';
+    url: string;
+} | {
+    kind: 'opaque';
+    description: string;
+};
+export interface SkillCandidate {
+    name: string;
+    description: string;
+    whenToUse?: string;
+    invocation: SkillInvocationPolicy;
+    provider: string;
+    source: SkillSource;
+    path?: string;
+    resourceBase?: SkillResourceBase;
+    rank: number;
+    locator: unknown;
+}
+export interface SkillDefinition {
+    name: string;
+    description: string;
+    invocation: SkillInvocationPolicy;
+    provider: string;
+    source: SkillSource;
+    path?: string;
+    resourceBase?: SkillResourceBase;
+    content: string;
+}
+export interface SkillLookupOptions {
+    cwd?: string;
+    signal?: AbortSignal;
+}
+export interface SkillProvider {
+    name: string;
+    list(options: SkillLookupOptions): Promise<readonly SkillCandidate[]>;
+    get(candidate: SkillCandidate, options: SkillLookupOptions): Promise<SkillDefinition | undefined>;
+}
+export interface SkillProviderControl {
+    signal: AbortSignal;
+    invalidate(): void;
+}
+export interface CommandInvocation {
+    agent: Agent;
+    rawInput: string;
+}
+export type CommandResult = {
+    kind: 'success';
+    text?: string;
+} | {
+    kind: 'error';
+    text: string;
+};
+export interface CommandDefinition {
+    name: string;
+    description: string;
+    input?: {
+        hint?: string;
+    };
+    handler(invocation: CommandInvocation): CommandResult | Promise<CommandResult>;
+}
+export interface PromptSection {
+    name: string;
+    order: number;
+    text: string | ((context: unknown) => string);
+    interpolate?: boolean;
+}
+export type SessionStartSource = 'startup' | 'resume' | 'clear' | 'compact';
+/** Listener signatures for the events this package subscribes to. */
+export interface HostEvents {
+    'agent/created': (payload: {
+        agent: Agent;
+        source?: SessionStartSource;
+        signal?: AbortSignal;
+    }) => undefined | Promise<undefined>;
+    'agent/pre-step': (payload: {
+        agent: Agent;
+        messages: UserMessage[];
+        turn?: number;
+        step?: number;
+        signal?: AbortSignal;
+    }, next: () => Promise<PreStepDecision>) => Promise<PreStepDecision>;
+    'agent/turn-stopping': (payload: {
+        agent: Agent;
+        turn?: number;
+        signal?: AbortSignal;
+    }) => undefined | Promise<undefined>;
+    'agent/disposed': (payload: {
+        agent: Agent;
+    }) => void;
+    'tools/pre-execute': (exec: ToolExecution, next: () => Promise<PreToolDecision>) => Promise<PreToolDecision>;
+    'tools/post-execute': (exec: ToolExecution, result: Readonly<ToolExecutionResult>, next: () => Promise<PostToolDecision>) => Promise<PostToolDecision>;
+    'tools/result': (exec: ToolExecution, result: ToolExecutionResult) => void;
+}
+export type HostEventSubscriber = UnionToIntersection<{
+    [K in keyof HostEvents]: (event: K, listener: HostEvents[K]) => unknown;
+}[keyof HostEvents]>;
+type UnionToIntersection<T> = (T extends unknown ? (value: T) => void : never) extends (value: infer I) => void ? I : never;
+export interface Logger {
+    warn(message: string): void;
+}
+/** A Cordis context, narrowed to what this package uses. Services are present only after `inject`. */
+export interface HostContext {
+    logger?: Logger;
+    skills?: {
+        registerProvider(create: (control: SkillProviderControl) => SkillProvider): unknown;
+    };
+    commands?: {
+        register(definition: CommandDefinition): unknown;
+    };
+    systemPrompt?: {
+        section(section: PromptSection): unknown;
+    };
+    workingDirectory?: {
+        get(session: Session): string;
+    };
+    inject(services: string[], callback: (ctx: HostContext) => void): unknown;
+    effect(execute: () => () => void): unknown;
+    on: HostEventSubscriber;
+}
+export {};
+//# sourceMappingURL=dsh-types.d.ts.map

package/dist/src/dsh-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-types.d.ts","sourceRoot":"","sources":["../../src/dsh-types.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAA;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;IAChC,MAAM,EAAE,aAAa,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,UAAU,CAAA;CACpB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,OAAO,EAAE;YAAE,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,GACnH;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,OAAO,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,GACpJ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAEjE,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,aAAa,CAAA;IACrB,cAAc,CAAC,IAAI,SAAS,YAAY,EAAE,CAAA;IAC1C,SAAS,CAAC,IAAI,SAAS,YAAY,EAAE,CAAA;IACrC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;CACjC;AAED,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,gEAAgE;IAChE,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IAClC,0DAA0D;IAC1D,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IACjC,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CACrC;AAED,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;IAAC,mBAAmB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAA;AAEzH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;CAAE,CAAA;AAE9F,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;CAClC;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,kBAAkB,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE,GAC/F;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAC;IAAC,kBAAkB,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAC;IAAC,kBAAkB,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE,CAAA;AAEnF,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAElD,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,OAAO,CAAA;IACvB,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAA;AAE3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,qBAAqB,CAAA;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,WAAW,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,iBAAiB,CAAA;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,qBAAqB,CAAA;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,WAAW,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,iBAAiB,CAAA;IAChC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAA;IACrE,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAA;CAClG;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,CAAA;IACnB,UAAU,IAAI,IAAI,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhG,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACzB,OAAO,CAAC,UAAU,EAAE,iBAAiB,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CAC/E;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,CAAA;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAA;AAE3E,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IACjI,gBAAgB,EAAE,CAChB,OAAO,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,EACtG,IAAI,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,KACjC,OAAO,CAAC,eAAe,CAAC,CAAA;IAC7B,qBAAqB,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IACzH,gBAAgB,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,KAAK,IAAI,CAAA;IACrD,mBAAmB,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;IAC5G,oBAAoB,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACtJ,cAAc,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAA;CAC3E;AAED,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;KACnD,CAAC,IAAI,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO;CACxE,CAAC,MAAM,UAAU,CAAC,CAAC,CAAA;AAEpB,KAAK,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,KAAK,CAAA;AAE3H,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,sGAAsG;AACtG,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE;QAAE,gBAAgB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,aAAa,GAAG,OAAO,CAAA;KAAE,CAAA;IAChG,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAA;KAAE,CAAA;IAC/D,YAAY,CAAC,EAAE;QAAE,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAA;KAAE,CAAA;IAC3D,gBAAgB,CAAC,EAAE;QAAE,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAA;KAAE,CAAA;IACpD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAA;IACzE,MAAM,CAAC,OAAO,EAAE,MAAM,MAAM,IAAI,GAAG,OAAO,CAAA;IAC1C,EAAE,EAAE,mBAAmB,CAAA;CACxB"}

package/dist/src/dsh-types.js

@@ -0,0 +1,6 @@
+// The slice of the DeepSeek Harness (DSH) host API this package touches, declared
+// structurally so the package does not pin a DSH version. Names and shapes follow the
+// d.ts files shipped in @deepseek-ai/dsh-agent, dsh-tools, dsh-skill, dsh-commands,
+// dsh-system-prompt, dsh-session and dsh-working-directory.
+export {};
+//# sourceMappingURL=dsh-types.js.map

package/dist/src/dsh-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-types.js","sourceRoot":"","sources":["../../src/dsh-types.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,sFAAsF;AACtF,oFAAoF;AACpF,4DAA4D"}

package/dist/src/hooks.d.ts

@@ -0,0 +1,38 @@
+import { type HookSpec } from './plugin-files.js';
+export declare const HOOK_STDOUT_LIMIT: number;
+export interface HookRunResult {
+    code: number | null;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+    truncated?: boolean;
+    aborted?: boolean;
+}
+export type HookDecision = 'allow' | 'deny' | 'ask' | 'block' | (string & {});
+export interface HookOutcome {
+    context: string[];
+    decision: HookDecision | undefined;
+    reason: string | undefined;
+    /** PreToolUse rewrite requested by the hook; DSH cannot apply it, so callers must fail closed. */
+    updatedInput: Record<string, unknown> | undefined;
+    /** Text for the operator log, never for the model. */
+    notices: string[];
+}
+/**
+ * Run one hook command with Claude Code's hook contract: JSON on stdin, exit 2 blocks.
+ * The hook runs in its own process group; a timeout or abort kills the whole group, and
+ * the result is taken at process exit, not when every inherited stdout handle closes.
+ */
+export declare function runHook(hook: Pick<HookSpec, 'command'> & {
+    args?: string[] | undefined;
+    timeout?: number;
+}, input: {
+    cwd?: string;
+} & Record<string, unknown>, env: Record<string, string | undefined>, signal?: AbortSignal): Promise<HookRunResult>;
+/**
+ * Normalize a hook result to one decision shape across events.
+ * @param event - Claude hook event; plain stdout counts as context only for
+ *   SessionStart and UserPromptSubmit, as in Claude Code.
+ */
+export declare function interpretHookResult(result: HookRunResult, event?: string): HookOutcome;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/src/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAczE,eAAO,MAAM,iBAAiB,QAAa,CAAA;AAO3C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAE7E,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAA;IAClC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,kGAAkG;IAClG,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IACjD,sDAAsD;IACtD,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAuDrP;AAWD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAqCtF"}

package/dist/src/hooks.js

@@ -0,0 +1,136 @@
+// Running Claude Code hook commands and reading their output.
+import { spawn } from 'node:child_process';
+import { DEFAULT_HOOK_TIMEOUT_S } from './plugin-files.js';
+const PLACEHOLDERS = ['CLAUDE_PLUGIN_ROOT', 'CLAUDE_PROJECT_DIR'];
+/** Exec-form substitution: each placeholder becomes its value as plain text, never shell syntax. */
+function expandPlaceholders(text, env) {
+    let out = text;
+    for (const name of PLACEHOLDERS) {
+        const value = env[name];
+        if (value !== undefined)
+            out = out.replaceAll('${' + name + '}', value).replaceAll('$' + name, value);
+    }
+    return out;
+}
+export const HOOK_STDOUT_LIMIT = 256 * 1024;
+// Grace period for stdout after the hook process exits, in case a backgrounded child
+// keeps the pipe open (Claude Code does not wait for those either).
+const HOOK_DRAIN_MS = 50;
+// Plain stdout and systemMessage reach the model only for these events, as in Claude Code.
+const PLAIN_CONTEXT_EVENTS = new Set(['SessionStart', 'UserPromptSubmit']);
+/**
+ * Run one hook command with Claude Code's hook contract: JSON on stdin, exit 2 blocks.
+ * The hook runs in its own process group; a timeout or abort kills the whole group, and
+ * the result is taken at process exit, not when every inherited stdout handle closes.
+ */
+export function runHook(hook, input, env, signal) {
+    return new Promise((resolvePromise) => {
+        let stdout = '';
+        let stderr = '';
+        let truncated = false;
+        let settled = false;
+        let drain;
+        const options = { cwd: input.cwd || process.cwd(), env, stdio: ['pipe', 'pipe', 'pipe'], detached: true };
+        const child = hook.args
+            ? spawn(expandPlaceholders(hook.command, env), hook.args.map((arg) => expandPlaceholders(arg, env)), options)
+            : spawn('/bin/sh', ['-c', hook.command], options);
+        const killGroup = () => {
+            try {
+                if (child.pid !== undefined)
+                    process.kill(-child.pid, 'SIGKILL');
+            }
+            catch {
+                child.kill('SIGKILL');
+            }
+        };
+        const timer = setTimeout(() => {
+            killGroup();
+            finish({ code: null, stdout, stderr: stderr + `\nhook timed out after ${hook.timeout}s`, timedOut: true, truncated });
+        }, (hook.timeout || DEFAULT_HOOK_TIMEOUT_S) * 1000);
+        const onAbort = () => {
+            killGroup();
+            finish({ code: null, stdout: '', stderr: 'hook cancelled', timedOut: false, truncated: false, aborted: true });
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+        function finish(result) {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            clearTimeout(drain);
+            signal?.removeEventListener('abort', onAbort);
+            child.stdout.destroy();
+            child.stderr.destroy();
+            resolvePromise(result);
+        }
+        child.stdout.on('data', (chunk) => {
+            if (stdout.length + chunk.length > HOOK_STDOUT_LIMIT)
+                truncated = true;
+            else
+                stdout += chunk;
+        });
+        child.stderr.on('data', (chunk) => {
+            if (stderr.length < HOOK_STDOUT_LIMIT)
+                stderr += chunk;
+        });
+        child.on('error', (error) => finish({ code: null, stdout, stderr: String(error), timedOut: false, truncated }));
+        child.on('exit', (code) => {
+            drain = setTimeout(() => finish({ code, stdout, stderr, timedOut: false, truncated }), HOOK_DRAIN_MS);
+        });
+        child.on('close', (code) => finish({ code, stdout, stderr, timedOut: false, truncated }));
+        child.stdin.on('error', () => { });
+        child.stdin.end(JSON.stringify(input));
+    });
+}
+/**
+ * Normalize a hook result to one decision shape across events.
+ * @param event - Claude hook event; plain stdout counts as context only for
+ *   SessionStart and UserPromptSubmit, as in Claude Code.
+ */
+export function interpretHookResult(result, event) {
+    const out = { context: [], decision: undefined, reason: undefined, updatedInput: undefined, notices: [] };
+    if (result.code === 2) {
+        out.decision = 'block';
+        out.reason = result.stderr.trim() || 'blocked by hook';
+        return out;
+    }
+    if (result.code !== 0)
+        return out;
+    if (result.truncated) {
+        out.notices.push(`hook output over ${HOOK_STDOUT_LIMIT} bytes was dropped`);
+        return out;
+    }
+    const text = result.stdout.trim();
+    if (!text)
+        return out;
+    let json;
+    try {
+        json = JSON.parse(text);
+    }
+    catch {
+        if (event === undefined || PLAIN_CONTEXT_EVENTS.has(event))
+            out.context.push(text);
+        return out;
+    }
+    const specific = json.hookSpecificOutput ?? {};
+    if (specific.additionalContext)
+        out.context.push(String(specific.additionalContext));
+    if (specific.updatedInput && typeof specific.updatedInput === 'object' && !Array.isArray(specific.updatedInput))
+        out.updatedInput = specific.updatedInput;
+    if (json.systemMessage)
+        out.notices.push(String(json.systemMessage));
+    if (specific.permissionDecision) {
+        out.decision = specific.permissionDecision;
+        out.reason = specific.permissionDecisionReason;
+    }
+    else if (json.decision) {
+        out.decision = json.decision === 'approve' ? 'allow' : json.decision;
+        out.reason = json.reason;
+    }
+    if (json.continue === false) {
+        out.decision = 'block';
+        out.reason = json.stopReason || out.reason;
+    }
+    return out;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/src/hooks.js.map

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

package/dist/src/plugin-files.d.ts

@@ -0,0 +1,92 @@
+export declare const DEFAULT_HOOK_TIMEOUT_S = 60;
+export type FrontMatter = Record<string, string>;
+export interface PluginManifest {
+    name: string;
+    version?: string;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface SkillFile {
+    name: string;
+    description: string;
+    path: string;
+    base: string;
+    meta: FrontMatter;
+}
+export interface CommandFile {
+    stem: string;
+    name: string;
+    description: string;
+    hint: string;
+    body: string;
+    path: string;
+}
+export interface AgentFile {
+    name: string;
+    description: string;
+    tools: string;
+    model: string;
+    body: string;
+    path: string;
+}
+export interface HookSpec {
+    event: string;
+    matcher: string;
+    command: string;
+    /** Exec form: `command` is spawned directly with these arguments, no shell. */
+    args?: string[];
+    /** `block` makes a crash, timeout or exit code other than 0 and 2 count as a block. */
+    onFailure?: 'block' | 'continue';
+    /** Seconds. */
+    timeout: number;
+}
+export interface SkillOptions {
+    exclude?: string[];
+    /** Renames `x` to `<prefix>-x`. Empty keeps bare names. */
+    prefix?: string;
+}
+export interface CommandOptions {
+    exclude?: string[];
+    /** DSH command prefix; defaults to the plugin name. Empty gives bare `/<name>`. */
+    prefix?: string;
+}
+export interface AgentOptions {
+    exclude?: string[];
+    /** Extra root-relative directories holding agent markdown files. */
+    extraDirs?: string[];
+}
+/** Split YAML-ish front matter from a markdown file. Only flat `key: value` lines are read. */
+export declare function parseFrontMatter(text: string): {
+    meta: FrontMatter;
+    body: string;
+};
+/**
+ * Remove `<!--harness:claude-only--> ... <!--/harness-->` blocks.
+ * An opener without a closer drops the rest of the file, so Claude-only text never leaks.
+ */
+export declare function stripClaudeOnlyBlocks(text: string): {
+    text: string;
+    unterminated: boolean;
+};
+export declare const stripClaudeOnly: (text: string) => string;
+/** Keep hook text from closing the tag it is wrapped in. */
+export declare const escapeClosingTag: (text: string, tag: string) => string;
+/** Replace the Claude plugin root variables with the real plugin directory. */
+export declare function expandPluginRoot(text: string, root: string): string;
+export declare const kebab: (value: unknown) => string;
+export declare function readText(path: string): string | undefined;
+/** Read the plugin manifest; the plugin name falls back to the directory name. */
+export declare function readManifest(root: string): PluginManifest;
+/** Skill directories: `skills/<name>/SKILL.md`. */
+export declare function discoverSkills(root: string, options?: SkillOptions): SkillFile[];
+/** Command files: `commands/<name>.md`. */
+export declare function discoverCommands(root: string, options?: CommandOptions): CommandFile[];
+/** Agent definitions: `agents/<name>.md` plus any extra directories the bundle lists. */
+export declare function discoverAgents(root: string, options?: AgentOptions): AgentFile[];
+/** hooks/hooks.json command hooks, flattened. Function-hook `modules` are Claude-only and skipped. */
+export declare function readHooks(root: string): HookSpec[];
+/** A Claude Code matcher: empty or `*` matches all, otherwise an anchored regex (`Bash`, `Skill|Agent|Task`). */
+export declare function matcherMatches(matcher: string, toolName: string): boolean;
+/** Expand `$ARGUMENTS`, `$1..$9` and `${CLAUDE_PLUGIN_ROOT}` in a command body. */
+export declare function renderCommand(body: string, rawInput: string, root: string): string;
+//# sourceMappingURL=plugin-files.d.ts.map

package/dist/src/plugin-files.d.ts.map

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