Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 | 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 2x 2x 2x 2x 2x 2x 2x 2x 2x 2x 2x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x | /**
* `agent.deepseek` — the harness as a `native` engine, loaded on demand.
*
* Nothing imports this module statically: `adapter/server/engine.ts` reaches it through
* `loadKind('Deepseek')` when a session of that kind starts, which is why a process with no
* `deepseek` account never looks for the harness binary or its client (`@@T-593`).
*/
import type {
IAgentEngineAccount,
IAgentSessionRequest,
IAgentSessionResult,
} from '@feasibleone/blong/types';
/**
* DeepSeek Harness as a `native` engine.
*
* The harness owns its loop, so this is not a turn: the client spawns a `dsh` runtime, a prompt runs
* until the whole agent is idle, and the tools are the harness's own, rooted at the ticket workspace
* (`@@D-711`). What the realm keeps is the engine's session id — the thing a later resume names — and
* the text it said, which is what the transcript records.
*
* One runtime per account is reused across calls, because spawning it is the expensive part: the
* module keeps them by account key and `engine.session.close` reaps them. The binary is deployment
* configuration (`dshBin`), never resolved by this file, so a process that never configures a DeepSeek
* account never looks for one (`@@D-700`).
*/
type Harness = {
run: (
prompt: string,
options?: {sessionId?: string},
) => Promise<{sessionId: string; finalResponse: string; events?: unknown[]}>;
close: () => Promise<void>;
};
const harnesses = new Map<string, Harness>();
const keyOf = (account: IAgentEngineAccount, workspacePath?: string): string =>
`${account.dshBin ?? 'dsh'}|${account.dshHome ?? ''}|${workspacePath ?? ''}`;
/**
* The launch spec a session is spawned with. Pure, so a test can assert it without a runtime.
*
* `cwd` is the ticket's workspace: the harness resolves every relative path against it and the
* sandbox it applies is the boundary this realm relies on (`@@D-711`).
*/
export const deepseekOptions = (
account: IAgentEngineAccount,
request: IAgentSessionRequest,
): Record<string, unknown> => ({
launch: {
...(account.dshBin && {dshBin: account.dshBin}),
...(account.dshHome && {dshHome: account.dshHome}),
},
...(request.workspacePath && {cwd: request.workspacePath}),
...(account.modelName && {model: account.modelName}),
...(account.maxOutputTokens !== undefined && {maxTokens: account.maxOutputTokens}),
});
const harnessOf = async (
account: IAgentEngineAccount,
request: IAgentSessionRequest,
): Promise<Harness> => {
const key = keyOf(account, request.workspacePath);
const existing = harnesses.get(key);
if (existing) return existing;
// The specifier is computed so the compiler does not require the package: a deployment without a
// DeepSeek account carries neither the client nor its runtime (`@@D-700`).
const moduleName = '@deepseek-ai/dsh-sdk-client';
const {DeepSeekHarness} = (await import(moduleName)) as {
DeepSeekHarness: new (options: unknown) => Harness;
};
const created = new DeepSeekHarness(deepseekOptions(account, request));
harnesses.set(key, created);
return created;
};
/** One native run. `sessionKey` is what makes the second call a resume rather than a new session. */
export const deepseekSession = async (
account: IAgentEngineAccount,
request: IAgentSessionRequest,
): Promise<IAgentSessionResult> => {
const harness = await harnessOf(account, request);
const result = await harness.run(request.prompt, {
...(request.sessionKey && {sessionId: request.sessionKey}),
});
return {
text: result.finalResponse,
sessionKey: result.sessionId,
finishReason: 'idle',
};
};
/** Reap the runtime an account was holding, which is what a session's close means here. */
export const deepseekClose = (account: IAgentEngineAccount, workspacePath?: string): void => {
const key = keyOf(account, workspacePath);
const harness = harnesses.get(key);
if (!harness) return;
harnesses.delete(key);
void harness.close().catch(() => undefined);
};
|