@newheap/platform-ai-chat 0.1.0

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@newheap/platform-ai-chat",
+  "version": "0.1.0",
+  "peerDependencies": {
+    "@angular/cdk": "^20.2.14",
+    "@angular/common": "^20.3.28",
+    "@angular/core": "^20.3.28",
+    "@angular/router": "^20.3.28",
+    "@ngx-translate/core": "^17.0.0",
+    "dompurify": "^3.4.0",
+    "marked": "^18.0.0",
+    "rxjs": "~7.8.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "sideEffects": false,
+  "exports": {
+    "./i18n/*.json": {
+      "default": "./i18n/*.json"
+    },
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/newheap-platform-ai-chat.mjs"
+    },
+    "./admin": {
+      "types": "./admin/index.d.ts",
+      "default": "./fesm2022/newheap-platform-ai-chat-admin.mjs"
+    },
+    "./testing": {
+      "types": "./testing/index.d.ts",
+      "default": "./fesm2022/newheap-platform-ai-chat-testing.mjs"
+    }
+  },
+  "license": "Apache-2.0",
+  "description": "Angular assistant panel for NewHeap AI chat endpoints with streaming, tool-call and approval cards.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NewHeap/NewHeap-Platform.git"
+  },
+  "homepage": "https://github.com/NewHeap/NewHeap-Platform#readme",
+  "bugs": {
+    "url": "https://github.com/NewHeap/NewHeap-Platform/issues"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "module": "fesm2022/newheap-platform-ai-chat.mjs",
+  "typings": "index.d.ts"
+}

package/testing/index.d.ts

@@ -0,0 +1,189 @@
+import { AssistantStatus, AgentSummary, Conversation, ClientContext, AssistantPreferences, ToolCatalogEntry, AdminAgentInput, McpServerInput } from '@newheap/platform-ai-chat';
+import * as _angular_core from '@angular/core';
+import { InjectionToken, EnvironmentProviders } from '@angular/core';
+
+/** Streams text as `message.delta` events, split into word-sized pieces. */
+interface NhAssistantMockTextStep {
+    /** Fixed text, or text built from the page context the client sent with the message. */
+    text: string | ((pageContext: ClientContext | null) => string);
+}
+/** Runs one tool: `tool.started` followed by `tool.completed`. */
+interface NhAssistantMockToolStep {
+    tool: {
+        toolId: string;
+        displayName: string;
+        toolVersion?: number;
+        argumentsPreview?: string | null;
+        resultPreview?: string | null;
+        /** Default `succeeded`. */
+        status?: 'succeeded' | 'failed';
+        resultCode?: string | null;
+    };
+}
+/**
+ * Pauses the turn for approval: `tool.started`, `approval.required` and
+ * `turn.completed` with status `waiting-for-approval`. The decision resumes the turn with
+ * the `approved` or `rejected` steps.
+ */
+interface NhAssistantMockApprovalStep {
+    approval: {
+        toolId: string;
+        displayName: string;
+        toolVersion?: number;
+        summary: string;
+        argumentsPreview: string;
+        targets: string[];
+        /** Default 300 seconds. */
+        expiresInSeconds?: number;
+        /** Result preview of the tool after approval. */
+        resultPreview?: string | null;
+        approved: NhAssistantMockStep[];
+        rejected: NhAssistantMockStep[];
+    };
+}
+/** Ends the stream with an `error` event. */
+interface NhAssistantMockErrorStep {
+    error: {
+        code: string;
+        messageKey: string;
+    };
+}
+/** Ends the turn with `turn.completed` status `failed`. */
+interface NhAssistantMockFailStep {
+    fail: {
+        errorCode: string;
+    };
+}
+type NhAssistantMockStep = NhAssistantMockTextStep | NhAssistantMockToolStep | NhAssistantMockApprovalStep | NhAssistantMockErrorStep | NhAssistantMockFailStep;
+/** A scripted assistant turn, chosen by matching the user's message. */
+interface NhAssistantMockTurn {
+    /** Case-insensitive substring, regular expression or predicate. Omit to match every message. */
+    match?: string | RegExp | ((text: string, agentId: string, pageContext: ClientContext | null) => boolean);
+    steps: NhAssistantMockStep[];
+}
+interface NhAssistantMockTiming {
+    /** Delay before the first event of a stream. Default 200 ms. */
+    firstEventDelayMs?: number;
+    /** Delay between events. Default 40 ms. */
+    eventDelayMs?: number;
+    /** Size of the byte chunks the stream is cut into, to exercise the client parser. Default 23. */
+    chunkSize?: number;
+}
+/** A tool that a simulated remote MCP server lists. */
+interface NhAssistantMockRemoteTool {
+    remoteName: string;
+    description: string;
+    /** Changing the hash between two syncs simulates a changed remote input schema. */
+    inputSchemaHash: string;
+    /** Remote annotation; the mock passes it on as an untrusted hint. */
+    readOnlyHint?: boolean | null;
+}
+/** A simulated MCP server. The mock stores `secret` but never returns it. */
+interface NhAssistantMockMcpServer extends McpServerInput {
+    remoteTools?: NhAssistantMockRemoteTool[];
+}
+/** A preconfigured agent. Code agents default to the scenario's chat agents. */
+interface NhAssistantMockAdminAgent extends AdminAgentInput {
+    source: 'code' | 'admin';
+}
+/**
+ * Administration data of the mock. Hosts without an admin scenario still get working
+ * `admin/*` endpoints with code agents derived from `agents` and an empty context.
+ */
+interface NhAssistantMockAdminScenario {
+    /** Default `true`. Without it `admin/*` answers `403`. */
+    canAdminister?: boolean;
+    context?: string;
+    /** Tool catalog for the selector picker. Enabled MCP tools are added automatically. */
+    tools?: ToolCatalogEntry[];
+    agents?: NhAssistantMockAdminAgent[];
+    mcpServers?: NhAssistantMockMcpServer[];
+    /** Policies the host knows; `requiredPolicy` must be one of them. Default: any value. */
+    policies?: string[];
+    /** Hosts that may receive the user's token (`forward-user-token`). Default: none. */
+    forwardUserTokenHosts?: string[];
+}
+/** The scenario the mock API plays without a back-end. */
+interface NhAssistantMockScenario {
+    /** Default `true`. */
+    enabled?: boolean;
+    limits?: Partial<AssistantStatus['limits']>;
+    agents: AgentSummary[];
+    /** Conversations that exist before the first request. */
+    conversations?: Conversation[];
+    /** Tried in order; the first matching turn answers. */
+    turns: NhAssistantMockTurn[];
+    timing?: NhAssistantMockTiming;
+    /** Stored preferences of the caller. Default: default style, informal, normal length. */
+    preferences?: AssistantPreferences;
+    admin?: NhAssistantMockAdminScenario;
+}
+/** One request the mock API received, for assertions in tests. */
+interface NhAssistantMockRequest {
+    method: string;
+    path: string;
+    headers: Record<string, string>;
+    body: unknown;
+}
+
+declare const NH_ASSISTANT_MOCK_SCENARIO: InjectionToken<NhAssistantMockScenario>;
+/**
+ * In-memory implementation of the assistant HTTP API and its event streams. It keeps
+ * conversations, plays scripted turns as contract events through a real
+ * `text/event-stream` response and handles approvals, cancellation and the feature flag.
+ */
+declare class NhAssistantMockBackend {
+    private readonly scenario;
+    private readonly config;
+    private readonly conversations;
+    private readonly pendingApprovals;
+    private readonly runs;
+    /** Page context of the latest message per conversation, as the server stores it. */
+    private readonly pageContexts;
+    private readonly enabledState;
+    private readonly admin;
+    private readonly canAdministerState;
+    private sequence;
+    /** Requests received so far, oldest first. */
+    readonly requests: NhAssistantMockRequest[];
+    readonly enabled: _angular_core.Signal<boolean>;
+    readonly canAdminister: _angular_core.Signal<boolean>;
+    constructor();
+    /** Switches the simulated `NewHeap:AI:Assistant:Enabled` flag. */
+    setEnabled(enabled: boolean): void;
+    /** Switches whether the caller passes the admin policy (`canAdminister`, `admin/*`). */
+    setCanAdminister(canAdminister: boolean): void;
+    /** Replaces the tools a simulated MCP server lists; the next sync picks them up. */
+    setRemoteTools(serverId: string, tools: NhAssistantMockRemoteTool[]): void;
+    /** A `fetch` implementation that answers the assistant endpoints below `apiBaseUrl`. */
+    readonly fetch: (input: string, init: RequestInit) => Promise<Response>;
+    private route;
+    private list;
+    private create;
+    private sendMessage;
+    private decide;
+    private cancel;
+    private playSteps;
+    private pauseForApproval;
+    private stream;
+    private findTurn;
+    private update;
+    private nextId;
+    private result;
+    private json;
+    private empty;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantMockBackend, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<NhAssistantMockBackend>;
+}
+
+/**
+ * Replaces the assistant transport with an in-memory back-end that plays `script`.
+ * Register it after `provideNhAssistant(...)` in the same injector. Every client feature
+ * (status, agents, conversations, streamed turns, approvals, cancellation) then works
+ * without a server. Inject `NhAssistantMockBackend` to switch the feature flag or to
+ * inspect the received requests.
+ */
+declare function provideNhAssistantMockApi(script: NhAssistantMockScenario): EnvironmentProviders;
+
+export { NH_ASSISTANT_MOCK_SCENARIO, NhAssistantMockBackend, provideNhAssistantMockApi };
+export type { NhAssistantMockAdminAgent, NhAssistantMockAdminScenario, NhAssistantMockApprovalStep, NhAssistantMockErrorStep, NhAssistantMockFailStep, NhAssistantMockMcpServer, NhAssistantMockRemoteTool, NhAssistantMockRequest, NhAssistantMockScenario, NhAssistantMockStep, NhAssistantMockTextStep, NhAssistantMockTiming, NhAssistantMockToolStep, NhAssistantMockTurn };