@abgov/nx-adsp 12.5.0 → 12.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abgov/nx-adsp",
-  "version": "12.5.0",
+  "version": "12.7.0",
   "license": "Apache-2.0",
   "main": "src/index.js",
   "description": "Government of Alberta - Nx plugin for ADSP apps.",
@@ -13,16 +13,17 @@
     "@abgov/nx-oc": "^12.0.0",
     "@nx-dotnet/core": "^3.0.0",
     "@nx/angular": "^22.0.0",
-    "@nx/express": "^22.0.0",
     "@nx/devkit": "^22.0.0",
-    "@nx/react": "^22.0.0",
     "@nx/eslint": "^22.0.0",
+    "@nx/express": "^22.0.0",
+    "@nx/react": "^22.0.0",
     "tslib": "^2.0.0"
   },
   "dependencies": {
     "axios": "^1.16.0",
     "enquirer": "^2.3.6",
-    "json-schema-to-typescript": "^13.0.1"
+    "json-schema-to-typescript": "^13.0.1",
+    "socket.io-client": "^4.8.3"
   },
   "generators": "./generators.json",
   "scripts": {},

package/src/generators/angular-app/angular-app.js

@@ -50,10 +50,6 @@ function addFiles(host, options) {
     }
     return addProxyConf;
 }
-function removeFiles(host, options) {
-    host.delete(`${options.projectRoot}/src/app/logo.svg`);
-    host.delete(`${options.projectRoot}/src/app/star.svg`);
-}
 function default_1(host, options) {
     return tslib_1.__awaiter(this, void 0, void 0, function* () {
         var _a, _b;

package/src/generators/angular-app/angular-app.js.map

@@ -1 +1 @@
-{"version":3,"file":"angular-app.js","sourceRoot":"","sources":["../../../../../../packages/nx-adsp/src/generators/angular-app/angular-app.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"angular-app.js","sourceRoot":"","sources":["../../../../../../packages/nx-adsp/src/generators/angular-app/angular-app.ts"],"names":[],"mappings":"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"}

package/src/generators/angular-app/files/AGENTS.md__tmpl__

@@ -0,0 +1,96 @@
+# AGENTS.md — <%= projectName %>
+
+Angular 19 frontend for the Alberta Digital Service Platform (ADSP).
+Generated by `nx g @abgov/nx-adsp:angular-app`.
+
+## Stack
+
+- **UI**: Angular 19 standalone + GoA design system (`@abgov/angular-components` — `Goab*` components)
+- **Auth**: `keycloak-angular` with `keycloak-js`
+- **Router**: Angular Router with `createAuthGuard` from `keycloak-angular`
+
+## Key files
+
+| File | Purpose |
+|------|---------|
+| `src/main.ts` | Entry — bootstraps `AppComponent` with `appConfig`, imports `zone.js` |
+| `src/app/app.config.ts` | `provideKeycloak` (PKCE, silent SSO), `provideRouter`, `provideHttpClient` |
+| `src/app/app.component.ts` | Shell — auth state, hero banner background workaround, public API call |
+| `src/app/app.routes.ts` | Routes — `/protected` with `createAuthGuard` |
+| `src/app/protected/protected.component.ts` | Protected route — shows authenticated user info |
+| `src/environments/environment.ts` | Access URL, realm, client ID — pre-set from ADSP tenant |
+
+## Auth pattern
+
+```typescript
+import Keycloak from 'keycloak-js';
+import { inject } from '@angular/core';
+
+private keycloak = inject(Keycloak); // provided by provideKeycloak in app.config.ts
+
+this.keycloak.authenticated          // boolean
+this.keycloak.tokenParsed?.['name']  // user display name
+this.keycloak.login()
+this.keycloak.logout({ redirectUri: window.location.origin })
+```
+
+Route guard using `createAuthGuard` from `keycloak-angular`:
+
+```typescript
+const authGuard = createAuthGuard(async (_route, _state, { authenticated, keycloak }) => {
+  if (authenticated) return true;
+  await keycloak.login({ redirectUri: window.location.href });
+  return false;
+});
+```
+
+## GoA design system
+
+Components are imported from `@abgov/angular-components` with the `Goab` prefix
+and added to each standalone component's `imports` array:
+
+```typescript
+import { GoabButton, GoabAppHeader } from '@abgov/angular-components';
+
+@Component({ imports: [GoabButton, GoabAppHeader], ... })
+```
+
+**Known limitation:** `GoabHeroBanner.backgroundUrl` does not bind reliably via
+Angular's template binding due to an `@if(isReady)` timing issue inside the
+component wrapper. Use `MutationObserver` to set the property directly after
+the inner `<goa-hero-banner>` element appears — see `app.component.ts` for the
+established pattern.
+
+## Backend API calls (mean / proxy setup)
+
+If `proxy.conf.json` exists at the project root, API calls are proxied to the
+backend service in development. Use relative `/api/` paths — do not hardcode
+the service URL:
+
+```typescript
+// ✓ correct — works through proxy in dev, nginx in production
+this.http.get('/api/v1/my-resource')
+
+// ✗ wrong — bypasses proxy, won't work in production
+this.http.get('http://localhost:3333/my-service/v1/my-resource')
+```
+
+`includeBearerTokenInterceptor` (configured in `app.config.ts`) automatically
+attaches the Keycloak access token to all outgoing HTTP requests.
+In production, `nginx.conf` contains the same proxy rule routing `/api/` to
+the backend service hostname.
+
+## Adding a new route
+
+1. Create `src/app/my-feature/my-feature.component.ts` as a standalone component
+2. Add the route to `src/app/app.routes.ts`
+3. Add required `Goab*` components to the new component's `imports` array
+
+## What NOT to change
+
+- `app.config.ts` — `provideKeycloak` initialises keycloak-js once; do not
+  create a second Keycloak instance elsewhere
+- `silent-check-sso.html` — served from `public/`; required for keycloak-js
+  silent SSO check on page load
+- `environments/environment.ts` — access URL and realm are pre-configured for
+  the ADSP tenant; override at runtime via environment variables

package/src/generators/express-service/express-service.js

@@ -6,6 +6,10 @@ const nx_oc_1 = require("@abgov/nx-oc");
 const devkit_1 = require("@nx/devkit");
 const eslint_1 = require("@nx/eslint");
 const path = require("path");
+const agent_1 = require("../../utils/agent");
+// Version of nx-adsp passed to the agent for template compatibility checks.
+// Keep in sync with package.json version.
+const PLUGIN_VERSION = '12.x';
 function normalizeOptions(host, options) {
     return tslib_1.__awaiter(this, void 0, void 0, function* () {
         const projectName = (0, devkit_1.names)(options.name).fileName;
@@ -22,6 +26,7 @@ function addFiles(host, options) {
 }
 function default_1(host, options) {
     return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
         const normalizedOptions = yield normalizeOptions(host, options);
         const { applicationGenerator: initExpress } = yield Promise.resolve().then(() => require('@nx/express'));
         yield initExpress(host, Object.assign(Object.assign({}, options), { skipFormat: true, skipPackageJson: false, linter: eslint_1.Linter.EsLint, unitTestRunner: 'jest', js: false, directory: `apps/${options.name}` }));
@@ -42,6 +47,25 @@ function default_1(host, options) {
         });
         addFiles(host, normalizedOptions);
         yield (0, devkit_1.formatFiles)(host);
+        // Consult the nx-adsp-agent to augment the project with ADSP capabilities.
+        // The agent has access to template tools and a workspace; it generates new
+        // files and modifications to integration files (main.ts, environment.ts)
+        // which are applied directly to the Nx Tree.
+        // Falls back silently if agent-service is unreachable or no accessToken.
+        if (normalizedOptions.adsp) {
+            const mainTs = (_b = (_a = host.read(`${normalizedOptions.projectRoot}/src/main.ts`)) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : '';
+            const environmentTs = (_d = (_c = host.read(`${normalizedOptions.projectRoot}/src/environment.ts`)) === null || _c === void 0 ? void 0 : _c.toString()) !== null && _d !== void 0 ? _d : '';
+            yield (0, agent_1.consultAgent)(normalizedOptions.adsp.directoryServiceUrl, options.accessToken, {
+                projectName: normalizedOptions.projectName,
+                projectType: 'express-service',
+                tenant: normalizedOptions.adsp.tenant,
+                pluginVersion: PLUGIN_VERSION,
+                existingFiles: {
+                    'src/main.ts': mainTs,
+                    'src/environment.ts': environmentTs,
+                },
+            }, host, normalizedOptions.projectRoot);
+        }
         yield (0, nx_oc_1.deploymentGenerator)(host, Object.assign(Object.assign({}, normalizedOptions), { appType: 'node', project: normalizedOptions.projectName }));
         return () => {
             (0, devkit_1.installPackagesTask)(host);

package/src/generators/express-service/express-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"express-service.js","sourceRoot":"","sources":["../../../../../../packages/nx-adsp/src/generators/express-service/express-service.ts"],"names":[],"mappings":";;AA6CA,4BA8CC;;AA3FD,wCAAyE;AACzE,uCAQoB;AACpB,uCAAoC;AACpC,6BAA6B;AAG7B,SAAe,gBAAgB,CAC7B,IAAU,EACV,OAAe;;QAEf,MAAM,WAAW,GAAG,IAAA,cAAK,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;QACjD,MAAM,WAAW,GAAG,GAAG,IAAA,2BAAkB,EAAC,IAAI,CAAC,CAAC,OAAO,IAAI,WAAW,EAAE,CAAC;QAEzE,MAAM,IAAI,GAAG,MAAM,IAAA,4BAAoB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEvD,uCACK,OAAO,KACV,WAAW;YACX,WAAW;YACX,IAAI,IACJ;IACJ,CAAC;CAAA;AAED,SAAS,QAAQ,CAAC,IAAU,EAAE,OAAyB;IACrD,MAAM,eAAe,iDAChB,OAAO,GACP,OAAO,CAAC,IAAI,KACf,IAAI,EAAE,EAAE,GACT,CAAC;IACF,IAAA,sBAAa,EACX,IAAI,EACJ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,WAAW,EACnB,eAAe,CAChB,CAAC;AACJ,CAAC;AAED,mBAA+B,IAAU,EAAE,OAAe;;QACxD,MAAM,iBAAiB,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEhE,MAAM,EAAE,oBAAoB,EAAE,WAAW,EAAE,GAAG,2CAAa,aAAa,EAAC,CAAC;QAC1E,MAAM,WAAW,CAAC,IAAI,kCACjB,OAAO,KACV,UAAU,EAAE,IAAI,EAChB,eAAe,EAAE,KAAK,EACtB,MAAM,EAAE,eAAM,CAAC,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,EAAE,EAAE,KAAK,EACT,SAAS,EAAE,QAAQ,OAAO,CAAC,IAAI,EAAE,IACjC,CAAC;QAEH,IAAA,qCAA4B,EAC1B,IAAI,EACJ;YACE,yBAAyB,EAAE,QAAQ;YACnC,WAAW,EAAE,QAAQ;YACrB,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,QAAQ;YAClB,oBAAoB,EAAE,QAAQ;SAC/B,EACD;YACE,oBAAoB,EAAE,QAAQ;YAC9B,aAAa,EAAE,SAAS;YACxB,iBAAiB,EAAE,SAAS;YAC5B,2BAA2B,EAAE,QAAQ;SACtC,CACF,CAAC;QAEF,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QAClC,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;QAExB,MAAM,IAAA,2BAAmB,EAAC,IAAI,kCACzB,iBAAiB,KACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,CAAC,WAAW,IACtC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,IAAA,4BAAmB,EAAC,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC;IACJ,CAAC;CAAA"}
+{"version":3,"file":"express-service.js","sourceRoot":"","sources":["../../../../../../packages/nx-adsp/src/generators/express-service/express-service.ts"],"names":[],"mappings":"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"}

package/src/generators/express-service/files/AGENTS.md__tmpl__

@@ -0,0 +1,76 @@
+# AGENTS.md — <%= projectName %>
+
+Node/Express backend service for the Alberta Digital Service Platform (ADSP).
+Generated by `nx g @abgov/nx-adsp:express-service`.
+
+## Stack
+
+- **Runtime**: Node.js + Express
+- **Auth**: passport.js with tenant strategy from `@abgov/adsp-service-sdk`
+- **Config**: `envalid` with `.env` file (see `src/environment.ts`)
+- **SDK**: `@abgov/adsp-service-sdk` — provides service registration, auth,
+  event publishing, configuration management, and service discovery
+
+## Key files
+
+| File | Purpose |
+|------|---------|
+| `src/main.ts` | App entry — SDK init, middleware, routes, server start |
+| `src/environment.ts` | Validated env config with defaults pre-set from ADSP tenant |
+
+## SDK capabilities
+
+`initializeService()` returns `capabilities`:
+
+```typescript
+const { logger, tenantStrategy, traceHandler, configurationHandler,
+        healthCheck, directory, tokenProvider, eventService } = capabilities;
+```
+
+To resolve another ADSP service URL:
+
+```typescript
+const url = await directory.getServiceUrl(AdspId.parse('urn:ads:platform:file-service'));
+```
+
+To call another service with an access token:
+
+```typescript
+const token = await tokenProvider.getAccessToken();
+```
+
+## Adding routes
+
+Add route handlers in `main.ts` under the `/<%= projectName %>/v1` path prefix:
+
+```typescript
+app.get('/<%= projectName %>/v1/my-resource', (req, res) => {
+  const user = req.user; // null for anonymous, populated for authenticated
+  res.json({ ... });
+});
+```
+
+`passport.authenticate(['tenant', 'anonymous'])` is applied to the entire
+`/<%= projectName %>/v1` prefix — check `req.user` inside handlers to
+distinguish authenticated from anonymous access.
+
+## Frontend proxy integration (mern / mean stacks)
+
+When this service is paired with a React or Angular frontend via the `mern` or
+`mean` generators, the frontend proxies `/api/` to this service:
+
+- **Dev** (webpack / Vite): `/api/v1/my-resource` → `/<%= projectName %>/v1/my-resource` on `localhost:3333`
+- **Production** (nginx): same rewrite via the nginx proxy block in the frontend app
+
+All API routes in this service live under `/<%= projectName %>/v1/`. The proxy
+rewrites the frontend's `/api/` prefix to `/<%= projectName %>/` before the
+request reaches Express, so `/<%= projectName %>/v1/public` maps to the
+frontend's `/api/v1/public`.
+
+## What NOT to change
+
+- `initializeService(...)` config — `CLIENT_ID` and `CLIENT_SECRET` are read
+  from environment; do not hardcode credentials
+- The passport strategy setup — the tenant strategy handles JWT validation
+- `configurationHandler` on the API path — provides configuration service
+  integration; keep it applied before route handlers

package/src/generators/react-app/files/AGENTS.md__tmpl__

@@ -0,0 +1,76 @@
+# AGENTS.md — <%= projectName %>
+
+React frontend for the Alberta Digital Service Platform (ADSP).
+Generated by `nx g @abgov/nx-adsp:react-app`.
+
+## Stack
+
+- **UI**: React 18 + GoA design system (`@abgov/react-components` — `Goab*` components)
+- **Auth**: `keycloak-js` via Redux Toolkit slice (`src/app/user.slice.ts`)
+- **State**: Redux Toolkit — store in `src/store.ts`
+- **Router**: React Router v6
+
+## Key files
+
+| File | Purpose |
+|------|---------|
+| `src/main.tsx` | Entry — Redux Provider, BrowserRouter, dispatches `initializeUser()` after render |
+| `src/app/user.slice.ts` | Keycloak auth — login, logout, token refresh, `getAccessToken()` |
+| `src/app/start.slice.ts` | Example public/private API calls |
+| `src/app/config.slice.ts` | Loads ADSP directory service endpoints on startup |
+| `src/app/intake.slice.ts` | Application domain state — extend this for your feature |
+| `src/store.ts` | Redux store — add new slices here |
+| `src/environments/environment.ts` | Access URL, realm, client ID — pre-set from ADSP tenant |
+
+## Auth pattern
+
+```typescript
+import { getAccessToken, loginUser, logoutUser, userSelector } from './user.slice';
+
+// In a component:
+const { authenticated, name } = useSelector(userSelector);
+dispatch(loginUser());   // redirects to Keycloak
+dispatch(logoutUser());  // redirects to Keycloak logout
+
+// In a thunk (for authenticated API calls):
+const token = await getAccessToken(); // refreshes token if needed
+```
+
+## GoA design system
+
+Components are imported from `@abgov/react-components` with the `Goab` prefix:
+
+```typescript
+import { GoabButton, GoabAppHeader, GoabButtonGroup } from '@abgov/react-components';
+```
+
+## Adding a new Redux slice
+
+1. Create `src/app/my-feature.slice.ts` using `createSlice` / `createAsyncThunk`
+2. Export the reducer and add it to `src/store.ts`
+
+## Backend API calls (mern / proxy setup)
+
+If `proxy.conf.json` exists at the project root, API calls are proxied to the
+backend service in development. Use relative `/api/` paths — do not hardcode
+the service URL:
+
+```typescript
+// ✓ correct — works through proxy in dev, nginx in production
+const response = await fetch('/api/v1/my-resource');
+
+// ✗ wrong — bypasses proxy, won't work in production
+const response = await fetch('http://localhost:3333/my-service/v1/my-resource');
+```
+
+In production, `nginx.conf` contains the same proxy rule routing `/api/` to
+the backend service hostname.
+
+## What NOT to change
+
+- `user.slice.ts` — keycloak-js is initialised once per app lifecycle; do not
+  create a second Keycloak instance
+- `environments/environment.ts` — access URL and realm are pre-configured for
+  the ADSP tenant; override at runtime via deployment config
+- `silent-check-sso.html` — required for keycloak-js silent SSO; must be served
+  from the app root

package/src/utils/agent.d.ts

@@ -0,0 +1,34 @@
+import { Tree } from '@nx/devkit';
+export interface AgentCapability {
+    generator: string;
+    params: Record<string, unknown>;
+    description: string;
+}
+export interface CapabilitySpec {
+    capabilities: AgentCapability[];
+}
+/**
+ * Result returned when the agent conversation completes.
+ * filesWritten is the number of files applied to the Nx Tree from the
+ * agent workspace (new files and modified integration files like main.ts).
+ */
+export interface AgentResult {
+    filesWritten: number;
+}
+/**
+ * Connect to the ADSP agent-service and conduct a multi-turn conversation
+ * with the nx-adsp-agent. The agent uses its workspace tools to write
+ * generated and modified files; this function retrieves the workspace state
+ * after the conversation and applies all files to the Nx Tree.
+ *
+ * Returns null if agent-service is unavailable — callers should skip the
+ * agent step gracefully in that case.
+ */
+export declare function consultAgent(directoryServiceUrl: string, accessToken: string, projectContext: {
+    projectName: string;
+    projectType: 'express-service' | 'react-app' | 'angular-app';
+    tenant: string;
+    pluginVersion: string;
+    /** Content of key integration files for the agent to read and potentially modify. */
+    existingFiles: Record<string, string>;
+}, host: Tree, projectRoot: string): Promise<AgentResult | null>;

package/src/utils/agent.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.consultAgent = consultAgent;
+const tslib_1 = require("tslib");
+const readline_1 = require("readline");
+const socket_io_client_1 = require("socket.io-client");
+const nx_oc_1 = require("@abgov/nx-oc");
+const AGENT_SERVICE_URN = 'urn:ads:platform:agent-service:v1';
+const AGENT_ID = 'nx-adsp-agent';
+/**
+ * Connect to the ADSP agent-service and conduct a multi-turn conversation
+ * with the nx-adsp-agent. The agent uses its workspace tools to write
+ * generated and modified files; this function retrieves the workspace state
+ * after the conversation and applies all files to the Nx Tree.
+ *
+ * Returns null if agent-service is unavailable — callers should skip the
+ * agent step gracefully in that case.
+ */
+function consultAgent(directoryServiceUrl, accessToken, projectContext, host, projectRoot) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const agentServiceUrl = yield resolveAgentServiceUrl(directoryServiceUrl);
+        if (!agentServiceUrl) {
+            return null;
+        }
+        return new Promise((resolve) => {
+            const socket = (0, socket_io_client_1.io)(agentServiceUrl, {
+                auth: { token: accessToken },
+                timeout: 30000,
+                reconnection: false,
+            });
+            const rl = (0, readline_1.createInterface)({ input: process.stdin, output: process.stdout });
+            const threadId = crypto.randomUUID();
+            let buffer = '';
+            let conversationDone = false;
+            // If stdin closes while waiting for user input, apply whatever the agent
+            // wrote to the workspace and continue generation.
+            rl.on('close', () => {
+                if (!conversationDone) {
+                    requestWorkspaceState();
+                }
+            });
+            const buildInitialMessage = () => {
+                const fileSection = Object.entries(projectContext.existingFiles)
+                    .map(([path, content]) => `${path}:\n\`\`\`typescript\n${content}\n\`\`\``)
+                    .join('\n\n');
+                return (`I am setting up a new ${projectContext.projectType} called "${projectContext.projectName}" ` +
+                    `for ADSP tenant "${projectContext.tenant}" (nx-adsp plugin version ${projectContext.pluginVersion}).\n\n` +
+                    `Existing project files:\n\n${fileSection}\n\n` +
+                    `What ADSP capabilities would be useful to integrate into this service?`);
+            };
+            const sendMessage = (content) => {
+                socket.emit('message', {
+                    agent: AGENT_ID,
+                    threadId,
+                    content,
+                    rawChunks: true,
+                });
+            };
+            const requestWorkspaceState = () => {
+                socket.emit('workspace-read', { agent: AGENT_ID, threadId });
+            };
+            const promptUser = () => {
+                rl.question('\n> ', (input) => {
+                    const trimmed = input.trim();
+                    if (trimmed) {
+                        sendMessage(trimmed);
+                    }
+                    else {
+                        // Empty input — user is skipping; resolve without files.
+                        cleanup(0);
+                    }
+                });
+            };
+            const applyWorkspaceFiles = (files) => {
+                let count = 0;
+                for (const file of files) {
+                    const fullPath = `${projectRoot}/${file.path}`;
+                    host.write(fullPath, file.content);
+                    count++;
+                }
+                return count;
+            };
+            const cleanup = (filesWritten) => {
+                conversationDone = true;
+                rl.close();
+                socket.disconnect();
+                resolve(filesWritten > 0 ? { filesWritten } : null);
+            };
+            socket.on('connect', () => {
+                sendMessage(buildInitialMessage());
+            });
+            socket.on('stream', ({ chunk, done }) => {
+                var _a, _b;
+                if ((chunk === null || chunk === void 0 ? void 0 : chunk.type) === 'text-delta') {
+                    const text = (_b = (_a = chunk.payload) === null || _a === void 0 ? void 0 : _a.text) !== null && _b !== void 0 ? _b : '';
+                    buffer += text;
+                    process.stdout.write(text);
+                }
+                if (done) {
+                    if (buffer.length > 0 && !buffer.endsWith('\n')) {
+                        process.stdout.write('\n');
+                    }
+                    buffer = '';
+                    // Agent has finished its response — request workspace state to get
+                    // any files it wrote, or ask user for follow-up if needed.
+                    requestWorkspaceState();
+                }
+            });
+            socket.on('workspace-state', ({ files }) => {
+                if ((files === null || files === void 0 ? void 0 : files.length) > 0) {
+                    const written = applyWorkspaceFiles(files);
+                    process.stdout.write(`\nApplied ${written} file(s) from agent workspace.\n`);
+                    cleanup(written);
+                }
+                else {
+                    // No files written yet — agent may need more input.
+                    promptUser();
+                }
+            });
+            socket.on('session-expired', () => {
+                process.stdout.write('\nAgent session expired.\n');
+                requestWorkspaceState();
+            });
+            socket.on('connect_error', () => cleanup(0));
+            socket.on('error', () => requestWorkspaceState());
+        });
+    });
+}
+function resolveAgentServiceUrl(directoryServiceUrl) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a;
+        try {
+            const urls = yield (0, nx_oc_1.getServiceUrls)(directoryServiceUrl);
+            return (_a = urls[AGENT_SERVICE_URN]) !== null && _a !== void 0 ? _a : null;
+        }
+        catch (_b) {
+            return null;
+        }
+    });
+}
+//# sourceMappingURL=agent.js.map

package/src/utils/agent.js.map

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

package/src/utils/agent.spec.ts

@@ -0,0 +1,118 @@
+import { consultAgent } from './agent';
+
+jest.mock('readline', () => ({
+  createInterface: jest.fn(() => ({
+    question: jest.fn((_prompt: string, cb: (answer: string) => void) => cb('')),
+    close: jest.fn(),
+    on: jest.fn(),
+  })),
+}));
+
+jest.mock('socket.io-client');
+jest.mock('@abgov/nx-oc', () => ({ getServiceUrls: jest.fn() }));
+jest.mock('@nx/devkit', () => ({ Tree: jest.fn() }));
+
+import { io } from 'socket.io-client';
+import { getServiceUrls } from '@abgov/nx-oc';
+
+const mockedIo = jest.mocked(io);
+const mockedGetServiceUrls = jest.mocked(getServiceUrls);
+
+const PROJECT_CONTEXT = {
+  projectName: 'test-service',
+  projectType: 'express-service' as const,
+  tenant: 'test-tenant',
+  pluginVersion: '12.x',
+  existingFiles: {
+    'src/main.ts': 'const app = express();',
+    'src/environment.ts': 'export const environment = {};',
+  },
+};
+
+const mockHost = { write: jest.fn(), read: jest.fn() } as unknown as import('@nx/devkit').Tree;
+
+function makeMockSocket() {
+  const handlers: Record<string, (...args: unknown[]) => void> = {};
+  const socket = {
+    on: jest.fn((event: string, handler: (...args: unknown[]) => void) => {
+      handlers[event] = handler;
+    }),
+    emit: jest.fn(),
+    disconnect: jest.fn(),
+    _handlers: handlers,
+  };
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  mockedIo.mockReturnValue(socket as any);
+  return socket;
+}
+
+const flushPromises = () => new Promise(resolve => setTimeout(resolve, 0));
+
+describe('consultAgent', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+    jest.spyOn(process.stdout, 'write').mockImplementation(() => true);
+  });
+
+  it('returns null when agent-service is not in directory', async () => {
+    mockedGetServiceUrls.mockResolvedValue({});
+    const result = await consultAgent('https://directory.example.com', 'token', PROJECT_CONTEXT, mockHost, 'apps/test-service');
+    expect(result).toBeNull();
+  });
+
+  it('returns null on socket connect error', async () => {
+    mockedGetServiceUrls.mockResolvedValue({
+      'urn:ads:platform:agent-service:v1': 'https://agent.example.com',
+    });
+    const socket = makeMockSocket();
+    const resultPromise = consultAgent('https://directory.example.com', 'token', PROJECT_CONTEXT, mockHost, 'apps/test-service');
+    await flushPromises();
+    socket._handlers['connect_error']?.();
+    expect(await resultPromise).toBeNull();
+  });
+
+  it('applies workspace files to Nx Tree and returns filesWritten count', async () => {
+    mockedGetServiceUrls.mockResolvedValue({
+      'urn:ads:platform:agent-service:v1': 'https://agent.example.com',
+    });
+    const socket = makeMockSocket();
+    const resultPromise = consultAgent('https://directory.example.com', 'token', PROJECT_CONTEXT, mockHost, 'apps/test-service');
+    await flushPromises();
+
+    socket._handlers['connect']?.();
+    socket._handlers['stream']?.({ chunk: null, done: true });
+    socket._handlers['workspace-state']?.({
+      files: [
+        { path: 'src/roles.ts', content: 'export enum ServiceRoles {}' },
+        { path: 'src/main.ts', content: 'updated main.ts' },
+      ],
+    });
+
+    const result = await resultPromise;
+    expect(result).toEqual({ filesWritten: 2 });
+    expect(mockHost.write).toHaveBeenCalledWith('apps/test-service/src/roles.ts', 'export enum ServiceRoles {}');
+    expect(mockHost.write).toHaveBeenCalledWith('apps/test-service/src/main.ts', 'updated main.ts');
+  });
+
+  it('includes existing file content in the initial message', async () => {
+    mockedGetServiceUrls.mockResolvedValue({
+      'urn:ads:platform:agent-service:v1': 'https://agent.example.com',
+    });
+    const socket = makeMockSocket();
+    const resultPromise = consultAgent('https://directory.example.com', 'token', PROJECT_CONTEXT, mockHost, 'apps/test-service');
+    await flushPromises();
+
+    socket._handlers['connect']?.();
+    socket._handlers['stream']?.({ chunk: null, done: true });
+    socket._handlers['workspace-state']?.({ files: [] });
+    await resultPromise;
+
+    expect(socket.emit).toHaveBeenCalledWith(
+      'message',
+      expect.objectContaining({
+        agent: 'nx-adsp-agent',
+        content: expect.stringContaining('src/main.ts'),
+      })
+    );
+  });
+});