@openbkn/dsh-business-context 0.1.5-rc.1

package/lib/types/provenance-view.d.ts

@@ -0,0 +1,11 @@
+import type { ProvenanceHandle, ProvenanceView } from './types.js';
+export interface ProvenanceViewLimits {
+    readonly maxGraphNodes: number;
+    readonly maxGraphEdges: number;
+}
+/**
+ * Projects Community execution facts plus the exact EE-owned interaction
+ * projection. It never derives BKN mappings from raw Core or MCP payloads.
+ */
+export declare function buildProvenanceView(handle: ProvenanceHandle, operationsResponse: unknown, enterpriseProjection: unknown | undefined, limits: ProvenanceViewLimits): ProvenanceView;
+//# sourceMappingURL=provenance-view.d.ts.map

package/lib/types/scoped-business-context.d.ts

@@ -0,0 +1,10 @@
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { NetworkCapabilityProfile } from './network-capability-profile.js';
+import type { PlatformReaderConfig } from './platform-reader.js';
+/**
+ * Mount the model-visible OpenBKN tool in one Agent's Cordis scope. An
+ * unbound or differently configured session gets no registration at all, so
+ * native DSH conversations keep their original tool catalogue.
+ */
+export declare function mountBoundBusinessNetworkTool(agent: Agent, config: PlatformReaderConfig, profile?: NetworkCapabilityProfile): boolean;
+//# sourceMappingURL=scoped-business-context.d.ts.map

package/lib/types/session-binding.d.ts

@@ -0,0 +1,35 @@
+import type { BusinessNetworkBinding } from './types.js';
+export type { BusinessNetworkBinding } from './types.js';
+/** Durable DSH event type for the business network selected by a session. */
+export declare const BUSINESS_NETWORK_BOUND_EVENT = "openbkn/business-network-bound";
+/** Minimal DSH session-log shape needed to restore an OpenBKN binding. */
+export interface SessionEventLike {
+    readonly type: string;
+    readonly data: unknown;
+}
+/** The event that a DSH adapter appends exactly once after a selection. */
+export interface BusinessNetworkBoundEvent {
+    readonly type: typeof BUSINESS_NETWORK_BOUND_EVENT;
+    readonly data: BusinessNetworkBinding;
+}
+export type BindBusinessNetworkResult = {
+    readonly kind: 'bound';
+    readonly event: BusinessNetworkBoundEvent;
+} | {
+    readonly kind: 'already-bound';
+    readonly binding: BusinessNetworkBinding;
+};
+/** A durable session already names a different OpenBKN network or platform. */
+export declare class BusinessNetworkBindingConflictError extends Error {
+    readonly existing: BusinessNetworkBinding;
+    readonly requested: BusinessNetworkBinding;
+    constructor(existing: BusinessNetworkBinding, requested: BusinessNetworkBinding);
+}
+/** Reconstruct the one permitted business-network binding from a DSH event log. */
+export declare function readBusinessNetworkBinding(events: readonly SessionEventLike[]): BusinessNetworkBinding | undefined;
+/**
+ * Decide whether selection emits the one durable event. The caller appends the
+ * returned event through DSH's session log; no in-memory side store exists.
+ */
+export declare function bindBusinessNetwork(events: readonly SessionEventLike[], requested: BusinessNetworkBinding): BindBusinessNetworkResult;
+//# sourceMappingURL=session-binding.d.ts.map

package/lib/types/suggested-prompts.d.ts

@@ -0,0 +1,3 @@
+/** The only prompt shown before a bound business session has a completed answer. */
+export declare function emptyBusinessSessionPrompt(displayName: string): string;
+//# sourceMappingURL=suggested-prompts.d.ts.map

package/lib/types/turn-provenance.d.ts

@@ -0,0 +1,25 @@
+import type { ProvenanceHandle } from './types.js';
+/** Durable session event binding one finalized assistant message to one OpenBKN interaction. */
+export declare const TURN_PROVENANCE_EVENT = "openbkn/turn-provenance";
+export interface TurnProvenanceEvent {
+    readonly type: typeof TURN_PROVENANCE_EVENT;
+    readonly data: {
+        readonly messageId: string;
+        readonly handle: ProvenanceHandle;
+    };
+}
+interface SessionEventLike {
+    readonly type: string;
+    readonly data: unknown;
+}
+/** A completed message cannot be rewritten to point at a different interaction. */
+export declare class TurnProvenanceConflictError extends Error {
+    readonly messageId: string;
+    constructor(messageId: string);
+}
+/** Return the one append-only provenance event to write, or undefined if already recorded identically. */
+export declare function appendTurnProvenance(events: readonly SessionEventLike[], messageId: string, handle: ProvenanceHandle): TurnProvenanceEvent | undefined;
+/** Recover the committed handle for exactly one finalized assistant message. */
+export declare function readTurnProvenance(events: readonly SessionEventLike[], messageId: string): ProvenanceHandle | undefined;
+export {};
+//# sourceMappingURL=turn-provenance.d.ts.map

package/lib/types/types.d.ts

@@ -0,0 +1,111 @@
+/** Safe, UI-ready representation of OpenBKN authentication state. */
+export type AuthSnapshot = {
+    readonly kind: 'authenticated';
+    readonly baseUrl: string;
+    readonly userId?: string;
+    readonly username?: string;
+} | {
+    readonly kind: 'authentication-required';
+    readonly baseUrl: string;
+} | {
+    readonly kind: 'platform-mismatch';
+    readonly expectedBaseUrl: string;
+    readonly actualBaseUrl: string;
+};
+/** The only platform-network fields allowed to cross from Host to Client. */
+export interface BusinessNetworkSummary {
+    readonly id: string;
+    readonly displayName: string;
+    readonly description?: string;
+    /** A local DSH workspace previously chosen for this network, if any. */
+    readonly workspacePath?: string;
+}
+/** Immutable network identity that may cross the generated Host/Client boundary. */
+export interface BusinessNetworkBinding {
+    readonly platformBaseUrl: string;
+    readonly knowledgeNetworkId: string;
+    readonly displayName: string;
+}
+/** Bounded, display-safe references for one completed OpenBKN-backed DSH turn. */
+export interface ProvenanceHandle {
+    readonly schemaVersion: 1;
+    readonly interactionId: string;
+    readonly requestIds: readonly string[];
+    readonly traceIds: readonly string[];
+    readonly receiptIds: readonly string[];
+    readonly status: 'completed' | 'failed';
+    readonly partial: boolean;
+}
+/** Public, bounded DTO returned by the Host-only provenance reader. */
+export interface ProvenanceOperationView {
+    readonly id: string;
+    readonly label: string;
+    readonly protocol?: string;
+    readonly status?: string;
+    readonly startedAt?: string;
+    readonly finishedAt?: string;
+    readonly requestId?: string;
+    readonly traceId?: string;
+    readonly receiptId?: string;
+}
+/** A display-safe element resolved by the Enterprise provenance service. */
+export interface ProvenanceBusinessElement {
+    readonly kind: 'object' | 'relation' | 'action' | 'property' | 'logic' | 'metric';
+    readonly id: string;
+    readonly name: string;
+    readonly parentId?: string;
+    readonly field?: string;
+}
+/** An Enterprise resolver result. The Host copies these facts; it does not derive mappings. */
+export interface ProvenanceBusinessOperation {
+    readonly id: string;
+    readonly attempt: number;
+    readonly toolName: string;
+    readonly knowledgeNetworkId?: string;
+    readonly status: 'resolved' | 'ambiguous' | 'unresolved' | 'not_evaluable';
+    readonly elements: readonly ProvenanceBusinessElement[];
+    readonly missingFacts: readonly string[];
+}
+export interface ProvenanceConversationContext {
+    readonly knowledgeNetworkId: string;
+    readonly sourceInteractionId: string;
+    readonly sourceOperationId: string;
+}
+export interface ProvenanceDerivedFact {
+    readonly rule: string;
+    readonly sourceOperationId: string;
+    readonly operationId: string;
+    readonly elementId: string;
+}
+/** A relationship disclosed by the Enterprise Interaction projection. */
+export interface ProvenanceContextRelation {
+    readonly id: string;
+    readonly knowledgeNetworkId: string;
+    readonly name: string;
+    readonly sourceObjectId: string;
+    readonly targetObjectId: string;
+}
+/** Enterprise BFF state, deliberately separate from Community execution facts. */
+export type ProvenanceBusinessView = {
+    readonly kind: 'unavailable';
+} | {
+    readonly kind: 'ready';
+    readonly operations: readonly ProvenanceBusinessOperation[];
+    readonly conversationContext: readonly ProvenanceConversationContext[];
+    readonly derivedFacts: readonly ProvenanceDerivedFact[];
+    readonly contextRelations: readonly ProvenanceContextRelation[];
+};
+/** The current Enterprise Interaction projection does not define an evidence-chain DTO. */
+export type ProvenanceEvidenceView = {
+    readonly kind: 'unavailable';
+};
+export interface ProvenanceView {
+    readonly interactionId: string;
+    readonly execution: {
+        readonly status?: string;
+        readonly operations: readonly ProvenanceOperationView[];
+    };
+    readonly business: ProvenanceBusinessView;
+    readonly evidence: ProvenanceEvidenceView;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/workspace-binding-registry.d.ts

@@ -0,0 +1,40 @@
+import { Service, type Context } from '@deepseek-ai/cordis';
+import { z } from 'zod';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** Durable, non-secret OpenBKN knowledge-network to DSH workspace mapping. */
+        openbknWorkspaceBindingRegistry: OpenBknWorkspaceBindingRegistry;
+    }
+}
+/** A local DSH workspace chosen for one OpenBKN business knowledge network. */
+export declare const workspaceBindingRecord: z.ZodObject<{
+    platformBaseUrl: z.ZodString;
+    knowledgeNetworkId: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    workspacePath: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type WorkspaceBindingRecord = z.infer<typeof workspaceBindingRecord>;
+/** Stable storage key: one configurable OpenBKN platform and network identity. */
+export declare function workspaceBindingKey(platformBaseUrl: string, knowledgeNetworkId: string): string;
+/**
+ * Host-owned durable index for the small, non-secret network-to-workspace
+ * association. It deliberately stores a path rather than a DSH workspace id:
+ * DSH resolves a registered workspace id from the path at each Client run.
+ */
+export declare class OpenBknWorkspaceBindingRegistry extends Service {
+    static inject: string[];
+    private table?;
+    constructor(ctx: Context);
+    protected [Service.init](): Promise<void>;
+    get(platformBaseUrl: string, knowledgeNetworkId: string): WorkspaceBindingRecord | undefined;
+    /**
+     * Return the one network associated with a native DSH workspace. Ambiguous
+     * workspace associations deliberately produce no result so a session is
+     * never bound to a network by guesswork.
+     */
+    findUniqueByWorkspace(platformBaseUrl: string, workspacePath: string): WorkspaceBindingRecord | undefined;
+    put(input: Omit<WorkspaceBindingRecord, 'updatedAt'>): Promise<WorkspaceBindingRecord>;
+    private requireTable;
+}
+//# sourceMappingURL=workspace-binding-registry.d.ts.map

package/package.json

@@ -0,0 +1,131 @@
+{
+  "name": "@openbkn/dsh-business-context",
+  "version": "0.1.5-rc.1",
+  "description": "OpenBKN business knowledge-network context for DeepSeek Harness",
+  "license": "Apache-2.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/openbkn-ai/bkn-dsh.git"
+  },
+  "homepage": "https://github.com/openbkn-ai/bkn-dsh#readme",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "openbkn",
+    "knowledge-network",
+    "business-context",
+    "provenance"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "main": "./lib/index.js",
+  "types": "./lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./types": {
+      "types": "./lib/types/types.d.ts"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./typert": {
+      "types": "./lib/typert.host.d.ts",
+      "default": "./lib/typert.host.js"
+    },
+    "./remote": {
+      "types": "./lib/typert.remote-client.d.ts",
+      "default": "./lib/typert.remote-client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts",
+    "lib/typert.host.js",
+    "lib/typert.host.d.ts",
+    "lib/typert.remote-client.js",
+    "lib/typert.remote-client.d.ts",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-ui-slots"
+      ],
+      "platform": "web"
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.2",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-agent": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-credentials": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-mcp-client": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-storage": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-storage-domain": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-subprocess": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-util-values": "0.1.6-alpha.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-agent": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-credentials": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-mcp-client": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-api-remotes": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-chat": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-layout": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-tool": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-workspace": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-api-workspace-controller": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-subprocess": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.6-alpha.2",
+    "@types/node": "^24.0.0",
+    "@deepseek-ai/dsh-util-values": "0.1.6-alpha.2",
+    "tsdown": "^0.22.2",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "tsx": "^4.23.13",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "pnpm run build:host && pnpm run build:client",
+    "build:host": "tsc -p tsconfig.package.host.json && tsdown --env.DSH_BUILD_FACE host",
+    "build:client": "tsc -p tsconfig.package.client.json && tsdown --env.DSH_BUILD_FACE client",
+    "test": "pnpm run build && node --import tsx --test tests/*.test.mjs tests/*.test.ts",
+    "typecheck": "tsc -b ../.."
+  }
+}