@ingram-cloud/pulumi 1.1.0 → 1.2.0

package/README.md

@@ -121,6 +121,29 @@ const bookkeeper = new ic.IcAgent("bookkeeper", {
 > keep it as the app's migration script. New smiths attach at birth in app code.
 > Pulumi does not own per-smith runtime state.
 
+### IcWebPage (declare in the APP repo)
+
+A **hosted page** — a private, shareable web page that runs an agent (a `web`
+deployment). Each visitor gets their own smith; the 128-bit `dep_` id in the URL is
+the privacy boundary, with an optional shared `password` on top. Point it at an
+`IcAgent` and read back `pageUrl` — the link to hand out.
+
+```ts
+const page = new ic.IcWebPage("docs-page", {
+  ...conn,
+  agentId: curator.agentId,
+  title: "Ingram Cloud docs assistant",
+  greeting: "Ask me anything about Ingram Cloud.",
+  // password: "optional-shared-secret",
+});
+
+export const pageUrl = page.pageUrl; // https://cloud.ingram.tech/hosted/dep_…
+```
+
+> The API has no update path for a web deployment's title/greeting/password, so a
+> change to any of those (or to `agentId`) **replaces** the page and mints a fresh
+> `pageUrl`. The agent's instructions change on the `IcAgent`, not here.
+
 ### IcMcpServer, IcOauthProvider, IcTelegramBot, IcWhatsAppConfig, IcEmail, IcWebhook, IcModelKey (declare in INFRA)
 
 ```ts

package/dist/resources.d.ts

@@ -248,3 +248,20 @@ export declare class IcProjectToken extends pulumi.dynamic.Resource {
     readonly tokenId: pulumi.Output<string>;
     constructor(name: string, args: IcProjectTokenArgs, opts?: pulumi.CustomResourceOptions);
 }
+export interface IcWebPageArgs {
+    baseUrl: pulumi.Input<string>;
+    token: pulumi.Input<string>;
+    /** The `agt_…` id this page runs. Typically an `IcAgent().agentId`. */
+    agentId: pulumi.Input<string>;
+    title?: pulumi.Input<string>;
+    greeting?: pulumi.Input<string>;
+    /** Optional shared password gating the page. */
+    password?: pulumi.Input<string>;
+}
+export declare class IcWebPage extends pulumi.dynamic.Resource {
+    /** The `dep_…` deployment id (same as `.id`, exposed for convenience). */
+    readonly deploymentId: pulumi.Output<string>;
+    /** The shareable page URL (e.g. `https://cloud.ingram.tech/hosted/dep_…`). */
+    readonly pageUrl: pulumi.Output<string>;
+    constructor(name: string, args: IcWebPageArgs, opts?: pulumi.CustomResourceOptions);
+}

package/dist/resources.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IcProjectToken = exports.IcProject = exports.IcModelKey = exports.IcWebhook = exports.IcEmail = exports.IcWhatsAppConfig = exports.IcOauthProvider = exports.IcTelegramBot = exports.IcMcpServer = exports.IcAgent = exports.IC_API_VERSION = void 0;
+exports.IcWebPage = exports.IcProjectToken = exports.IcProject = exports.IcModelKey = exports.IcWebhook = exports.IcEmail = exports.IcWhatsAppConfig = exports.IcOauthProvider = exports.IcTelegramBot = exports.IcMcpServer = exports.IcAgent = exports.IC_API_VERSION = void 0;
 /**
  * Ingram Cloud /v1 tenant configuration as Pulumi dynamic resources.
  *
@@ -799,3 +799,53 @@ class IcProjectToken extends pulumi.dynamic.Resource {
     }
 }
 exports.IcProjectToken = IcProjectToken;
+const webPageProvider = {
+    async create(i) {
+        const body = {
+            target: { type: "agent", id: i.agentId },
+            kind: "web",
+            provider_metadata: {
+                ...(i.title ? { title: i.title } : {}),
+                ...(i.greeting ? { greeting: i.greeting } : {}),
+            },
+        };
+        if (i.password)
+            body.secrets = { password: i.password };
+        const res = await icRequest(i.baseUrl, i.token, "POST", "/v1/deployments", body);
+        return {
+            id: res.id,
+            outs: { ...i, deploymentId: res.id, pageUrl: res.page_url },
+        };
+    },
+    async update(_id, olds, news) {
+        // No web-metadata PATCH on the API — diff marks every field as a replace, so
+        // this path is only reached for a no-op refresh. Carry outputs forward.
+        return { outs: { ...news, deploymentId: _id, pageUrl: olds.pageUrl } };
+    },
+    async delete(id, props) {
+        await icRequest(props.baseUrl, props.token, "DELETE", `/v1/deployments/${id}`);
+    },
+    async diff(_id, olds, news) {
+        return simpleDiff(olds, news, {
+            replaceKeys: ["agentId", "title", "greeting", "password"],
+        });
+    },
+    async read(id, props) {
+        return read404(() => icRequest(props.baseUrl, props.token, "GET", `/v1/deployments/${id}`), (dep) => ({
+            id,
+            props: {
+                ...props,
+                title: dep.provider_metadata?.title,
+                greeting: dep.provider_metadata?.greeting,
+                deploymentId: id,
+                pageUrl: dep.page_url,
+            },
+        }));
+    },
+};
+class IcWebPage extends pulumi.dynamic.Resource {
+    constructor(name, args, opts) {
+        super(webPageProvider, name, { deploymentId: undefined, pageUrl: undefined, ...args }, { ...opts, additionalSecretOutputs: ["token", "password"] });
+    }
+}
+exports.IcWebPage = IcWebPage;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ingram-cloud/pulumi",
-	"version": "1.1.0",
+	"version": "1.2.0",
 	"description": "Pulumi dynamic resources for the Ingram Cloud /v1 API — projects, project tokens, agents, MCP servers, channels, webhooks, model keys.",
 	"license": "MIT",
 	"homepage": "https://cloud.ingram.tech",