@chengxianglibra/dsh-data-analysis 0.1.1 → 0.2.0

package/lib/types/client/right-tabs/install.d.ts

@@ -0,0 +1,18 @@
+import { resourceAddress } from './navigation.ts';
+export declare const inject: string[];
+/** Default browser integration. Layout belongs to Harness; mutable content belongs to occurrences. */
+export declare function installRightTabs(ctx: any, { diagnostics }?: {
+    diagnostics?: boolean | undefined;
+}): {
+    audit: {
+        opens: never[];
+        errors: never[];
+        changes: never[];
+    };
+    pages: Map<any, any>;
+    navigate: (sessionId: any, target: any, actions?: any, automatic?: boolean, params?: undefined) => void;
+    changed: (workspaceId: any, reportId: any) => void;
+    credentials: import("../credentials/model.ts").CredentialClientModel;
+    resourceAddress: typeof resourceAddress;
+    ask: (page: any, context: any) => void;
+};

package/lib/types/client/right-tabs/live-delivery.d.ts

@@ -0,0 +1,8 @@
+import type { SessionEventWindow } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { PresentationDelivery } from '../../presentation/receipt.ts';
+/** Read-only Session window consumer. Initial history and replacement never navigate. */
+export declare class LiveDeliveryObserver {
+    #private;
+    constructor(sessionId: string, onDelivery: (delivery: PresentationDelivery) => void);
+    consume(window: SessionEventWindow, baseline?: boolean): void;
+}

package/lib/types/client/right-tabs/navigation.d.ts

@@ -0,0 +1,17 @@
+import { type SemanticRef } from '../../semantic-reference/contracts.ts';
+export type Directory = 'datasources' | 'semantic' | 'reports';
+export type Resource = {
+    kind: 'report';
+    workspaceId: string;
+    reportId: string;
+    buildId?: string;
+} | {
+    kind: 'semantic';
+    workspaceId: string;
+    ref: SemanticRef;
+};
+export declare const directoryKind: (page: Directory) => string;
+export declare const definitionId: (kind: string) => string;
+export declare function resourceAddress(target: Resource): string;
+export declare function parseResource(address: string): Resource;
+export declare function canOpenResource(address: string, kind: Resource['kind']): boolean;

package/lib/types/client/right-tabs/page.d.ts

@@ -0,0 +1,36 @@
+import type { PresentationReceipt } from '../../presentation/contracts/types.ts';
+import { CredentialClientModel } from '../credentials/model.ts';
+import { ReportCatalogModel } from '../presentation/catalog-model.ts';
+import { PresentationDeliveryModel, type PresentationRpc } from '../presentation/delivery-model.ts';
+import type { ReaderViewMemory } from '../presentation/reader.tsx';
+import { SemanticBrowserModel } from '../semantic-browser/model.ts';
+import type { Directory, Resource } from './navigation.ts';
+export type PageTarget = Resource | {
+    kind: Directory;
+    workspaceId: string;
+};
+export interface PageState {
+    error?: string;
+    notice?: string;
+    newer?: PresentationReceipt;
+}
+/** Lifetime belongs to a Host tab occurrence, never to a React body mount. */
+export declare class TabPage {
+    #private;
+    readonly sessionId: string;
+    readonly target: PageTarget;
+    readonly reader: PresentationDeliveryModel;
+    readonly catalog: ReportCatalogModel;
+    readonly semantic: SemanticBrowserModel;
+    readonly datasources: CredentialClientModel;
+    readonly viewMemory: ReaderViewMemory;
+    constructor(sessionId: string, target: PageTarget, rpc: PresentationRpc, occurrenceId?: string);
+    getSnapshot: () => PageState;
+    subscribe: (listener: () => void) => () => void;
+    patch(change: Partial<PageState>): void;
+    navigate(revision: number, force?: boolean, history?: boolean): Promise<void>;
+    refresh(confirmDiscard?: () => boolean): Promise<void>;
+    publicationChanged(workspaceId: string, reportId?: string): Promise<void>;
+    unavailable(message: string): void;
+    dispose(): void;
+}

package/lib/types/client/right-tabs/styles.d.ts

@@ -0,0 +1,2 @@
+/** Host-only chrome. Portable reports keep their own independent stylesheet. */
+export declare const rightTabStyles = "\n.rt-page{height:100%;width:100%;min-width:0;overflow:auto;padding:16px;box-sizing:border-box;color:var(--dsw-alias-label-primary,#182a33);background:var(--dsw-alias-bg-base,#fff);container-type:inline-size;font:14px/1.6 system-ui,sans-serif}\n.rt-page *{box-sizing:border-box}.rt-page h2{font-size:18px;overflow-wrap:anywhere}.rt-page .rt-heading{margin:0 0 4px}.rt-heading-row{display:flex;align-items:center;justify-content:space-between;gap:16px;margin-bottom:4px}.rt-page .rt-heading-row .rt-heading{margin:0}.rt-heading-row>button{flex:none}.rt-caption{color:var(--dsw-alias-label-secondary,#627580);font-size:12px;margin:0 0 16px;overflow-wrap:anywhere}\n.rt-toolbar{display:flex;flex-wrap:wrap;align-items:center;gap:8px;padding-bottom:12px;border-bottom:1px solid var(--dsw-alias-border-l2,#dce4e8);margin-bottom:16px}\n.rt-page button,.rt-page select,.rt-page input{font:inherit;color:inherit;max-width:100%}.rt-page button{cursor:pointer;border:1px solid var(--dsw-alias-border-l2,#dce4e8);background:var(--dsw-alias-bg-base,#fff);border-radius:7px;padding:6px 10px}.rt-page button:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover,#edf4f3)}.rt-page button:disabled{opacity:.5;cursor:default}.rt-page :focus-visible{outline:2px solid var(--dsw-alias-state-business-primary,#087b70);outline-offset:3px}\n.rt-page select{padding:8px;border:1px solid var(--dsw-alias-border-l2,#dce4e8);border-radius:7px;background:var(--dsw-alias-bg-base,#fff)}.rt-page [role=alert]{color:var(--dsw-alias-state-warn-label,#b14927);overflow-wrap:anywhere}.rt-notice{padding:12px;border:1px solid var(--dsw-alias-border-l2,#dce4e8);border-radius:8px;background:var(--dsw-alias-bg-module-platform,#f5f7f9)}\n.rt-page .pd-catalog{padding:0;overflow:auto}.rt-page .pd-history{position:static;max-height:300px;border:1px solid var(--dsw-alias-border-l2,#dce4e8);border-radius:8px;margin-bottom:16px;width:100%}\n.rt-page .rt-refresh{display:grid;place-items:center;padding:7px;border-color:transparent;background:transparent}\n@container(max-width:650px){.rt-page .pr-reader{padding:24px 4px}.rt-page .pr-reader h1{font-size:25px}.rt-page .pr-block-metric{padding:14px}.rt-page .pr-metric-value{font-size:clamp(18px,7cqi,30px)}}\n";

package/lib/types/client/rpc.d.ts

@@ -0,0 +1,3 @@
+/** Keep feature RPC names while using Harness's authenticated shared API transport. */
+import type { ClientConnectionRpc } from '@deepseek-ai/dsh-client-connection/client';
+export declare function createPluginRpc(rpc: ClientConnectionRpc): ClientConnectionRpc;

package/lib/types/client/semantic-reference.d.ts

@@ -0,0 +1,4 @@
+import type { ReferenceInsert } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import { type Envelope } from '../semantic-reference/contracts.ts';
+/** Both the @ picker and semantic details insert exactly this Host reference. */
+export declare function semanticReference(envelope: Envelope): ReferenceInsert;

package/lib/types/client/workspace-header-action.d.ts

@@ -0,0 +1,7 @@
+export declare function WorkspaceHeaderAction({ label, icon, disabled, title, onClick, }: {
+    label: string;
+    icon: 'semantic' | 'credentials' | 'reports';
+    disabled: boolean;
+    title?: string;
+    onClick: () => void;
+}): import("react").JSX.Element;

package/lib/types/client/workspace-shortcuts.d.ts

@@ -0,0 +1,15 @@
+import type { SessionSnapshot } from '@deepseek-ai/dsh-api-session-controller/client';
+import { type ConversationSnapshot } from '@deepseek-ai/dsh-client-ui-conversation/client';
+export declare const workspaceDirectories: {
+    readonly datasources: "marivo.credentials.datasources-and-credentials";
+    readonly semantic: "marivo.navigation.semantic-layer";
+    readonly reports: "marivo.presentation.reports";
+};
+export type WorkspaceDirectory = keyof typeof workspaceDirectories;
+/** Only the Host's blank phase exposes preparation actions; drafts are untouched. */
+export declare function WorkspaceShortcuts({ session, conversation, disabled, open, }: {
+    session?: SessionSnapshot;
+    conversation?: ConversationSnapshot;
+    disabled: boolean;
+    open: (page: WorkspaceDirectory) => void;
+}): import("react").JSX.Element | null;

package/lib/types/client.d.ts

@@ -1,125 +1,10 @@
 import type { Context } from '@deepseek-ai/cordis';
-export declare const MARIVO_CREDENTIAL_STORAGE_PREFIX = "DSH_DATA_ANALYSIS_CREDENTIAL_";
-declare const EVIDENCE_SOURCES_META_KIND = "marivo-evidence-sources";
-declare const EVIDENCE_SOURCES_META_VERSION = 2;
-/** Browser-side copy of the Host mapping; contract tests keep both implementations identical. */
-export declare function marivoCredentialStorageRef(ref: string): string;
-export interface MarivoEvidenceSource {
-    status: 'available' | 'missing' | 'unsupported';
-    title: string;
-    locator: string;
-    excerpt: string | null;
-    truncated: boolean;
-    environmentFingerprint: string;
-    sessionId: string;
-    findingId: string;
-    findingType: string | null;
-    epistemicKind: string | null;
-    artifactRef: string;
-    canonicalItemKey: string | null;
-    committedAt: string | null;
-    sourceRefs: string[];
-    revalidation: {
-        status: string;
-        semanticStatus: string | null;
-        evidenceStatus: string | null;
-        dependencyStatus: string | null;
-    } | null;
-}
-export interface MarivoEvidenceSourcesMeta {
-    readonly kind: typeof EVIDENCE_SOURCES_META_KIND;
-    readonly version: typeof EVIDENCE_SOURCES_META_VERSION;
-    readonly dshSessionId: string;
-    readonly sources: readonly MarivoEvidenceSource[];
-}
-export interface MarivoEvidenceSourcesTurnDelivery {
-    readonly seq: number;
-    readonly sources: readonly MarivoEvidenceSource[];
-}
-export interface MarivoEvidenceSourcesTurnData {
-    readonly deliveries: readonly MarivoEvidenceSourcesTurnDelivery[];
-}
-interface MarivoEvidenceSourcesTurnState {
-    readonly turn: number;
-    readonly calls: ReadonlyMap<string, string>;
-    readonly deliveries: readonly MarivoEvidenceSourcesTurnDelivery[];
-}
-export interface MarivoEvidenceArtifactGroup {
-    readonly key: string;
-    readonly environmentFingerprint: string;
-    readonly sessionId: string;
-    readonly artifactRef: string;
-    readonly sources: readonly MarivoEvidenceSource[];
-}
-declare module '@deepseek-ai/dsh-client-runtime/client' {
-    interface ConversationTurnDataMap {
-        /** Explicitly requested Marivo Evidence sources collected from this exact Turn. */
-        'marivo-evidence-sources-delivery': MarivoEvidenceSourcesTurnData;
-    }
-}
-/** Parse the closed per-call source attachment persisted in Tool result metadata. */
-export declare function parseEvidenceSourcesMeta(value: unknown): MarivoEvidenceSourcesMeta | null;
-/** Decode the Code Mode-only source attachment from a durable sub-dispatch result. */
-export declare function parseEvidenceSourcesDurableContent(value: unknown): {
-    readonly turn: number;
-    readonly meta: MarivoEvidenceSourcesMeta;
-} | null;
-/** Recover one successful native or nested source attachment. */
-export declare function evidenceSourcesDeliveryFromEvent(event: any, calls?: ReadonlyMap<string, string>): MarivoEvidenceSourcesTurnDelivery | null;
-/** Aggregate explicit source attachments under one Harness-owned Turn key. */
-export declare const marivoEvidenceSourcesDeliveryDefinition: {
-    kind: string;
-    match(event: any): {
-        id: string;
-        role: string;
-    } | null;
-    start(_context: any, match: any): MarivoEvidenceSourcesTurnState;
-    update(context: any, match: any): MarivoEvidenceSourcesTurnState;
-    buildLocationData(context: any, scope: string): {
-        kind: string;
-        turn: any;
-        key: string;
-        value: {
-            deliveries: any;
-        };
-    } | null;
-};
-/** Successful sources completed before this exact closing Assistant message. */
-export declare function evidenceSourcesForClosing(owner: any): readonly MarivoEvidenceSource[];
-export declare function selectMarivoEvidenceSources(owner: any): readonly MarivoEvidenceSource[] | null;
-/** Group source presentation only; this does not infer Evidence equivalence or compatibility. */
-export declare function groupMarivoEvidenceSources(sources: readonly MarivoEvidenceSource[]): readonly MarivoEvidenceArtifactGroup[];
-export interface NeedsCredentialsResult {
-    status: 'needs-credentials';
-    name: string;
-    refs: string[];
-}
-export declare function parseNeedsCredentials(text: string): NeedsCredentialsResult | null;
-export declare function shouldAutoOpen(sessionId: string, callId: string, result: NeedsCredentialsResult | null): boolean;
-export declare function blankCredentialValues(refs: readonly string[]): Record<string, string>;
-export declare class CredentialDialogController {
-    readonly api: any;
-    constructor(api: any);
-    describe(refs: readonly string[]): Promise<Record<string, {
-        configured: boolean;
-    }>>;
-    inspect(refs: readonly string[]): Promise<{
-        configured: Record<string, boolean>;
-        missing: string[];
-        shouldOpen: boolean;
-    }>;
-    save(values: Readonly<Record<string, string>>): Promise<{
-        ok: boolean;
-        saved: string[];
-        errors: Record<string, string>;
-    }>;
-}
-export declare function MarivoDatasourceTestToolView(props: any): import("react").JSX.Element;
-export declare function MarivoDatasourceAccessToolView(props: any): import("react").JSX.Element;
-export declare function MarivoEvidenceSourcesPanel({ matched: sources, t, }: {
-    matched: readonly MarivoEvidenceSource[];
-    t: (key: string, values?: Record<string, string>) => string;
-}): import("react").JSX.Element;
-export declare const inject: string[];
-export declare function apply(ctx: Context): void;
-export {};
+import { inject, installRightTabs } from './client/right-tabs/install.tsx';
+export { marivoPresentationDeliveryDefinition, parsePresentationDurableContent, presentationDeliveryFromEvent, presentationsForNode, } from './client/presentation/delivery.ts';
+export { PresentationDeliveryModel } from './client/presentation/delivery-model.ts';
+export { HostPresentationReader } from './client/presentation/host-entry.tsx';
+export { inject };
+export declare function apply(ctx: Context, options?: {
+    diagnostics?: boolean;
+    onInstalled?: (controller: ReturnType<typeof installRightTabs>) => void;
+}): void;

package/lib/types/compatibility.d.ts

@@ -10,14 +10,14 @@ export interface DshDataAnalysisCompatibility {
         readonly packageSpec: string;
     };
     readonly contracts: {
-        readonly runtimeInstallation: 'dsh-data-analysis-runtime/v2';
+        readonly runtimeInstallation: 'dsh-data-analysis-runtime/v3';
         readonly subprocessPolicy: 'direct-argv-inherited-env-snapshot-overlay-v2';
     };
 }
 /** The package semver and the compatibility contract shipped in this exact installation. */
 export declare const PLUGIN_VERSION: string;
 export declare const DSH_DATA_ANALYSIS_COMPATIBILITY: DshDataAnalysisCompatibility;
-/** Every DSH peer is required and must use this one verified release. */
+/** Every DSH peer is required and must satisfy this declared compatibility range. */
 export declare const DSH_PEER_RANGE: string;
 export declare const DSH_DISTRIBUTION: "@deepseek-ai/dsh";
 export declare const DSH_PEER_DEPENDENCIES: Readonly<{
@@ -25,5 +25,5 @@ export declare const DSH_PEER_DEPENDENCIES: Readonly<{
 }>;
 export declare const MARIVO_VERSION: string;
 export declare const MARIVO_PACKAGE_SPEC: string;
-export declare const RUNTIME_INSTALLATION_VERSION: "dsh-data-analysis-runtime/v2";
+export declare const RUNTIME_INSTALLATION_VERSION: "dsh-data-analysis-runtime/v3";
 export declare const SUBPROCESS_POLICY_VERSION: "direct-argv-inherited-env-snapshot-overlay-v2";

package/lib/types/datasource/authoring.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+export declare const datasourceAuthoringSchema: z.ZodObject<{
+    fingerprint: z.ZodString;
+    backends: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        fields: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                json: "json";
+            }>;
+            required: z.ZodBoolean;
+            description: z.ZodString;
+            default: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type DatasourceAuthoring = z.infer<typeof datasourceAuthoringSchema>;
+export interface DatasourceConfiguration {
+    name: string;
+    backend: string;
+    fields: Record<string, unknown>;
+    version: string;
+}
+export interface DatasourceUpdateInput extends DatasourceCreateInput {
+    name: string;
+    version: string;
+}
+export interface DatasourceCreateInput {
+    backend: string;
+    fields: Record<string, unknown>;
+}
+export declare const DATASOURCE_AUTHORING_PROGRAM: string;

package/lib/types/datasource/bridge.d.ts

@@ -1,6 +1,7 @@
-import type { JsonValue } from '@deepseek-ai/dsh-session';
+import type { JsonValue } from '@deepseek-ai/dsh-util-values';
 import type { MarivoBridgeSource } from '../environment/source.ts';
 import type { MarivoCheckedRunner, MarivoEnvironmentBinding } from '../environment/types.ts';
+import { type DatasourceAuthoring, type DatasourceConfiguration, type DatasourceCreateInput, type DatasourceUpdateInput } from './authoring.ts';
 interface JsonObject {
     [key: string]: JsonValue;
 }
@@ -13,7 +14,10 @@ export interface MarivoDatasourceFailure extends JsonObject {
 }
 export interface MarivoDatasourceRepair extends JsonObject {
     kind: string;
-    help_target: string;
+    help_target: {
+        surface: string;
+        canonical_id: string | null;
+    };
     action: string;
     snippet: string | null;
     candidates: string[];
@@ -21,7 +25,11 @@ export interface MarivoDatasourceRepair extends JsonObject {
 }
 export interface MarivoDatasourceDescription {
     name: string;
+    backend?: string;
+    properties?: Record<string, JsonValue>;
     refs: string[];
+    fields: Record<string, string>;
+    definition: string;
 }
 export interface MarivoDatasourceTestResult {
     name: string;
@@ -32,9 +40,23 @@ export interface MarivoDatasourceTestResult {
 }
 export interface MarivoDatasourceBridgePort {
     readonly binding: Readonly<MarivoEnvironmentBinding>;
+    remove?(description: Readonly<MarivoDatasourceDescription>, signal?: AbortSignal): Promise<{
+        name?: string;
+        error?: string;
+    }>;
+    authoring?(signal?: AbortSignal): Promise<DatasourceAuthoring>;
+    create?(input: DatasourceCreateInput, signal?: AbortSignal): Promise<{
+        name?: string;
+        error?: string;
+    }>;
+    configuration?(name: string, signal?: AbortSignal): Promise<DatasourceConfiguration>;
+    update?(input: DatasourceUpdateInput, signal?: AbortSignal): Promise<{
+        name?: string;
+        error?: string;
+    }>;
     describe(name: string, signal?: AbortSignal): Promise<MarivoDatasourceDescription>;
     inventory(signal?: AbortSignal): Promise<MarivoDatasourceDescription[]>;
-    test(name: string, environmentOverlay: Readonly<NodeJS.ProcessEnv>, signal?: AbortSignal): Promise<MarivoDatasourceTestResult>;
+    test(description: Readonly<MarivoDatasourceDescription>, values: Readonly<Record<string, string>>, signal?: AbortSignal): Promise<MarivoDatasourceTestResult>;
 }
 export type MarivoDatasourceBridgeSource = MarivoBridgeSource<MarivoDatasourceBridgePort>;
 export type MarivoDatasourceInventoryBridge = Pick<MarivoDatasourceBridgePort, 'inventory'>;
@@ -44,9 +66,26 @@ export declare class MarivoDatasourceBridge {
     #private;
     readonly binding: Readonly<MarivoEnvironmentBinding>;
     constructor(runner: MarivoCheckedRunner);
+    authoring(signal?: AbortSignal): Promise<DatasourceAuthoring>;
+    configuration(name: string, signal?: AbortSignal): Promise<DatasourceConfiguration>;
+    update(input: DatasourceUpdateInput, signal?: AbortSignal): Promise<{
+        name?: string;
+        error?: string;
+    }>;
+    create(input: DatasourceCreateInput, signal?: AbortSignal): Promise<{
+        name?: string;
+        error?: string;
+    }>;
     describe(name: string, signal?: AbortSignal): Promise<MarivoDatasourceDescription>;
+    remove(description: Readonly<MarivoDatasourceDescription>, signal?: AbortSignal): Promise<{
+        error: string;
+        name?: undefined;
+    } | {
+        name: string;
+        error?: undefined;
+    }>;
     inventory(signal?: AbortSignal): Promise<MarivoDatasourceDescription[]>;
-    test(name: string, environmentOverlay: Readonly<NodeJS.ProcessEnv>, signal?: AbortSignal): Promise<MarivoDatasourceTestResult>;
+    test(description: Readonly<MarivoDatasourceDescription>, values: Readonly<Record<string, string>>, signal?: AbortSignal): Promise<MarivoDatasourceTestResult>;
 }
 export declare function resolveMarivoDatasourceBridge(source: MarivoDatasourceBridgeSource): Promise<MarivoDatasourceBridgePort>;
 export declare function resolveMarivoDatasourceInventoryBridge(source: MarivoDatasourceInventoryBridgeSource): Promise<MarivoDatasourceInventoryBridge>;

package/lib/types/datasource/changes-contract.d.ts

@@ -0,0 +1,18 @@
+import type { TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol';
+import type { TypertContribution } from '@deepseek-ai/dsh-typert-registry';
+import { z } from 'zod';
+export declare const CREDENTIAL_CHANGES_SERVICE = "dshDataAnalysisCredentials";
+export declare const credentialRevisionSchema: z.ZodObject<{
+    generation: z.ZodString;
+    cursor: z.ZodString;
+}, z.core.$strict>;
+export type CredentialRevision = z.infer<typeof credentialRevisionSchema>;
+export declare const credentialChangesHost: TypertContribution;
+export declare const credentialChangesRemote: TypertRemoteContribution;
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface TypertRemoteNamespaceMap {
+        dshDataAnalysisCredentials: {
+            changes(sessionId: string, signal?: AbortSignal): AsyncIterable<CredentialRevision>;
+        };
+    }
+}

package/lib/types/datasource/changes.d.ts

@@ -0,0 +1,15 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import { type CredentialRevision } from './changes-contract.ts';
+import { type MarivoCredentialService } from './service.ts';
+/** Reuses the Host's logical stream carrier; credentials and waiting calls keep their owner. */
+export declare class CredentialChangesService extends TypertRemoteService {
+    private readonly credentials;
+    private readonly lifetime;
+    private readonly tasks;
+    private closing?;
+    constructor(ctx: Context, credentials: Pick<MarivoCredentialService, 'waitWatch'>);
+    changes(sessionId: string, caller: AbortSignal): AsyncIterable<CredentialRevision>;
+    private snapshot;
+    close(): Promise<void>;
+}

package/lib/types/datasource/configure.d.ts

@@ -0,0 +1,7 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type ToolDefinition } from '@deepseek-ai/dsh-tools';
+import { type MarivoDatasourceBridgeSource } from './bridge.ts';
+import type { MarivoCredentialService } from './service.ts';
+export declare const MARIVO_DATASOURCE_CONFIGURE_TOOL_NAME = "marivo_datasource_configure";
+export declare function createMarivoDatasourceConfigureTool(source: MarivoDatasourceBridgeSource, service: MarivoCredentialService): ToolDefinition;
+export declare function registerMarivoDatasourceConfigureTool(ctx: Context, source: MarivoDatasourceBridgeSource, service: MarivoCredentialService): () => Promise<void>;

package/lib/types/datasource/defaults.d.ts

@@ -0,0 +1,7 @@
+import type { DatasourceAuthoring } from './authoring.ts';
+export type DatasourceDefaults = Record<string, Record<string, unknown>>;
+export type DatasourceAuthoringView = DatasourceAuthoring & {
+    creationDefaults?: DatasourceDefaults;
+};
+/** Validate against this Workspace's live Runtime; never include config values in errors. */
+export declare function withDatasourceDefaults(schema: DatasourceAuthoring, configured: unknown): DatasourceAuthoringView;

package/lib/types/datasource/index.d.ts

@@ -1,8 +1,11 @@
-export type { MarivoDatasourceAccessOptions, MarivoDatasourceAccessValue, } from './access.ts';
-export { createMarivoDatasourceAccessTool, MARIVO_DATASOURCE_ACCESS_TOOL_NAME, registerMarivoDatasourceAccessTool, } from './access.ts';
+export type { DatasourceConfiguration, DatasourceUpdateInput } from './authoring.ts';
 export type { MarivoDatasourceBridgePort, MarivoDatasourceBridgeSource, MarivoDatasourceDescription, MarivoDatasourceFailure, MarivoDatasourceInventoryBridge, MarivoDatasourceInventoryBridgeSource, MarivoDatasourceRepair, MarivoDatasourceTestResult, } from './bridge.ts';
 export { MarivoDatasourceBridge, resolveMarivoDatasourceBridge, resolveMarivoDatasourceInventoryBridge, } from './bridge.ts';
-export type { MarivoShellLeaseReceipt } from './shell-env.ts';
-export { assertMarivoCredentialReferences, DEFAULT_MARIVO_CREDENTIAL_LEASE_MAX_USES, DEFAULT_MARIVO_CREDENTIAL_LEASE_TTL_MS, MARIVO_CREDENTIAL_LEASE_PREFIX, MARIVO_CREDENTIAL_STORAGE_PREFIX, MarivoShellCredentialLeases, marivoCredentialStorageRef, } from './shell-env.ts';
-export type { MarivoDatasourceTestOptions, MarivoDatasourceTestValue, } from './test.ts';
+export { createMarivoDatasourceConfigureTool, MARIVO_DATASOURCE_CONFIGURE_TOOL_NAME, registerMarivoDatasourceConfigureTool, } from './configure.ts';
+export type { MarivoPythonExecutionSummary } from './python.ts';
+export { MarivoPythonExecutionError, registerMarivoPythonTool } from './python.ts';
+export type { MarivoPythonOptions } from './python-options.ts';
+export type { ConfigurationRequestView, ConfigurationResult, DatasourceConfigureInput, } from './service.ts';
+export { MarivoCredentialService } from './service.ts';
+export { assertMarivoCredentialReferences, MARIVO_CREDENTIAL_STORAGE_PREFIX, marivoCredentialStorageRef, } from './shell-env.ts';
 export { createMarivoDatasourceTestTool, MARIVO_DATASOURCE_TEST_TOOL_NAME, registerMarivoDatasourceTestTool, } from './test.ts';

package/lib/types/datasource/python-options.d.ts

@@ -0,0 +1,9 @@
+export declare const DEFAULT_PYTHON_TIMEOUT_MS = 120000;
+export declare const DEFAULT_PYTHON_MAX_TIMEOUT_MS = 600000;
+export interface MarivoPythonOptions {
+    pythonTimeoutMs?: number;
+    pythonMaxTimeoutMs?: number;
+}
+/** Do not echo rejected inputs: tool arguments and configuration are not trusted diagnostics. */
+export declare function pythonTimeout(value: unknown, name: string): number;
+export declare function resolvePythonOptions(options: MarivoPythonOptions): Required<MarivoPythonOptions>;

package/lib/types/datasource/python.d.ts

@@ -0,0 +1,19 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type MarivoDatasourceBridgeSource } from './bridge.ts';
+import { type MarivoPythonOptions } from './python-options.ts';
+import { type MarivoCredentialService } from './service.ts';
+export interface MarivoPythonExecutionSummary {
+    phase: 'preparing' | 'executing' | 'capturing-code';
+    reason: 'not-started' | 'succeeded' | 'nonzero-exit' | 'timed-out' | 'cancelled' | 'unknown';
+    requestedTimeoutMs: number | null;
+    effectiveTimeoutMs: number | null;
+    elapsedMs: number;
+    executionElapsedMs: number | null;
+    nextAction: string | null;
+}
+/** The message survives Harness error normalization; it contains only safe adapter facts. */
+export declare class MarivoPythonExecutionError extends Error {
+    readonly execution: MarivoPythonExecutionSummary;
+    constructor(message: string, execution: MarivoPythonExecutionSummary);
+}
+export declare function registerMarivoPythonTool(ctx: Context, source: MarivoDatasourceBridgeSource, service: MarivoCredentialService, options?: MarivoPythonOptions): () => Promise<void>;

package/lib/types/datasource/resolver-program.d.ts

@@ -0,0 +1,6 @@
+/** Shared Python adapter. All inputs below arrive on a Host-owned pipe. */
+export declare const RESOLVER_PROGRAM: string;
+/** The worker checks the exact binding and enters scope before any user code. */
+export declare const PYTHON_WORKER: string;
+/** Capture raw fd output before Harness collection/spill, including driver writes. */
+export declare const PYTHON_LAUNCHER: string;

package/lib/types/datasource/rpc.d.ts

@@ -0,0 +1,5 @@
+import type { HostConnectionHandle } from '@deepseek-ai/dsh-client-connection';
+import type { MarivoDatasourceBridgePort } from './bridge.ts';
+import { type DatasourceDefaults } from './defaults.ts';
+import { type MarivoCredentialService } from './service.ts';
+export declare function registerCredentialRpc(connection: HostConnectionHandle, service: MarivoCredentialService, workspace: (id: string) => Promise<MarivoDatasourceBridgePort>, datasourceDefaults?: DatasourceDefaults): () => Promise<void>;