@rippling/rippling-sdk 0.2.0-alpha.100

package/lib/manifest/acp-agent.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACPAgent = void 0;
+const existing_manifest_context_1 = require("./existing-manifest-context.js");
+const _existing_component_fields_1 = require("./_existing-component-fields.js");
+/**
+ * Defines an Agent Control Plane agent for Composer.
+ *
+ * New agents use their `apiName` as the Composer source handle, so a
+ * source-executed manifest does not need to persist a separate identifier.
+ */
+class ACPAgent {
+    static toDeletionIdentifier(sourceAgentId) {
+        return {
+            type: ACPAgent.componentType,
+            source_agent_id: sourceAgentId,
+        };
+    }
+    constructor(scope, props, sourceAgentId = props.apiName) {
+        if (props.identityMode !== 'runner') {
+            throw new Error('ACP agents support only runner identity.');
+        }
+        if (props['skills'] !== undefined) {
+            throw new Error('ACP Agent skill references are not supported by this SDK release.');
+        }
+        this._sourceAgentId = sourceAgentId;
+        this._apiName = props.apiName;
+        this._name = props.name;
+        this._description = props.description;
+        this._eventTriggers = [...props.eventTriggers];
+        this._files = [...props.files];
+        this._entrypoint = props.entrypoint;
+        scope._register(this);
+    }
+    /** Loads this ACP agent from the active existing-manifest JSON context. */
+    static loadFromExisting(apiName, options = {}) {
+        return (0, existing_manifest_context_1.getExistingManifestContext)(options).loadACPAgent(apiName);
+    }
+    /** @internal Hydrates an ACP agent from existing manifest wire JSON. */
+    static _fromExistingComponent(scope, component) {
+        if (component['skill_ids'] !== undefined) {
+            throw new Error('ACP Agent skill references are not supported by this SDK release.');
+        }
+        const identityMode = (0, _existing_component_fields_1.requireStringComponentField)(component, 'identity_mode', ACPAgent.componentType);
+        if (identityMode !== 'runner') {
+            throw new Error('ACP agents support only runner identity.');
+        }
+        const props = {
+            apiName: (0, _existing_component_fields_1.requireStringComponentField)(component, 'api_name', ACPAgent.componentType),
+            name: (0, _existing_component_fields_1.requireStringComponentField)(component, 'name', ACPAgent.componentType),
+            description: (0, _existing_component_fields_1.requireStringComponentField)(component, 'description', ACPAgent.componentType, {
+                allowEmpty: true,
+            }),
+            identityMode,
+            files: (0, _existing_component_fields_1.requireArrayComponentField)(component, 'files', ACPAgent.componentType).map((file) => ({
+                path: (0, _existing_component_fields_1.requireStringComponentField)(file, 'path', ACPAgent.componentType),
+                content: (0, _existing_component_fields_1.requireStringComponentField)(file, 'content', ACPAgent.componentType),
+                kind: (0, _existing_component_fields_1.requireStringComponentField)(file, 'kind', ACPAgent.componentType),
+            })),
+            entrypoint: (0, _existing_component_fields_1.requireStringComponentField)(component, 'entrypoint', ACPAgent.componentType),
+            eventTriggers: (0, _existing_component_fields_1.requireArrayComponentField)(component, 'event_triggers', ACPAgent.componentType).map((trigger) => ({
+                key: (0, _existing_component_fields_1.requireStringComponentField)(trigger, 'key', ACPAgent.componentType),
+                eventKey: (0, _existing_component_fields_1.requireStringComponentField)(trigger, 'event_key', ACPAgent.componentType),
+                rqlFormula: (0, _existing_component_fields_1.requireStringComponentField)(trigger, 'rql_formula', ACPAgent.componentType, {
+                    allowEmpty: true,
+                }),
+                promptTemplate: (0, _existing_component_fields_1.requireStringComponentField)(trigger, 'prompt_template', ACPAgent.componentType),
+                enabled: (0, _existing_component_fields_1.requireBooleanComponentField)(trigger, 'enabled', ACPAgent.componentType),
+            })),
+        };
+        return new ACPAgent(scope, props, (0, _existing_component_fields_1.requireStringComponentField)(component, 'source_agent_id', ACPAgent.componentType));
+    }
+    getSourceAgentId() {
+        return this._sourceAgentId;
+    }
+    getApiName() {
+        return this._apiName;
+    }
+    setName(name) {
+        this._name = name;
+        return this;
+    }
+    setDescription(description) {
+        this._description = description;
+        return this;
+    }
+    setIdentity(identityMode) {
+        if (identityMode !== 'runner') {
+            throw new Error('ACP agents support only runner identity.');
+        }
+        return this;
+    }
+    setEventTriggers(eventTriggers) {
+        this._eventTriggers = [...eventTriggers];
+        return this;
+    }
+    setSource(files, entrypoint) {
+        this._files = [...files];
+        this._entrypoint = entrypoint;
+        return this;
+    }
+    toDict() {
+        const component = {
+            type: ACPAgent.componentType,
+            source_agent_id: this._sourceAgentId,
+            api_name: this._apiName,
+            name: this._name,
+            description: this._description,
+            identity_mode: 'runner',
+            files: this._files.map((file) => ({
+                type: ACPAgent.componentType,
+                path: file.path,
+                content: file.content,
+                kind: file.kind,
+            })),
+            entrypoint: this._entrypoint,
+            event_triggers: this._eventTriggers.map((trigger) => ({
+                type: ACPAgent.componentType,
+                key: trigger.key,
+                event_key: trigger.eventKey,
+                rql_formula: trigger.rqlFormula ?? '',
+                prompt_template: trigger.promptTemplate,
+                enabled: trigger.enabled ?? true,
+            })),
+        };
+        return component;
+    }
+}
+exports.ACPAgent = ACPAgent;
+ACPAgent.componentType = 'ACP_AGENT';
+//# sourceMappingURL=acp-agent.js.map

package/lib/manifest/acp-agent.js.map

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

package/lib/manifest/acp-agent.mjs

@@ -0,0 +1,127 @@
+import { getExistingManifestContext } from "./existing-manifest-context.mjs";
+import { requireArrayComponentField, requireBooleanComponentField, requireStringComponentField, } from "./_existing-component-fields.mjs";
+/**
+ * Defines an Agent Control Plane agent for Composer.
+ *
+ * New agents use their `apiName` as the Composer source handle, so a
+ * source-executed manifest does not need to persist a separate identifier.
+ */
+export class ACPAgent {
+    static toDeletionIdentifier(sourceAgentId) {
+        return {
+            type: ACPAgent.componentType,
+            source_agent_id: sourceAgentId,
+        };
+    }
+    constructor(scope, props, sourceAgentId = props.apiName) {
+        if (props.identityMode !== 'runner') {
+            throw new Error('ACP agents support only runner identity.');
+        }
+        if (props['skills'] !== undefined) {
+            throw new Error('ACP Agent skill references are not supported by this SDK release.');
+        }
+        this._sourceAgentId = sourceAgentId;
+        this._apiName = props.apiName;
+        this._name = props.name;
+        this._description = props.description;
+        this._eventTriggers = [...props.eventTriggers];
+        this._files = [...props.files];
+        this._entrypoint = props.entrypoint;
+        scope._register(this);
+    }
+    /** Loads this ACP agent from the active existing-manifest JSON context. */
+    static loadFromExisting(apiName, options = {}) {
+        return getExistingManifestContext(options).loadACPAgent(apiName);
+    }
+    /** @internal Hydrates an ACP agent from existing manifest wire JSON. */
+    static _fromExistingComponent(scope, component) {
+        if (component['skill_ids'] !== undefined) {
+            throw new Error('ACP Agent skill references are not supported by this SDK release.');
+        }
+        const identityMode = requireStringComponentField(component, 'identity_mode', ACPAgent.componentType);
+        if (identityMode !== 'runner') {
+            throw new Error('ACP agents support only runner identity.');
+        }
+        const props = {
+            apiName: requireStringComponentField(component, 'api_name', ACPAgent.componentType),
+            name: requireStringComponentField(component, 'name', ACPAgent.componentType),
+            description: requireStringComponentField(component, 'description', ACPAgent.componentType, {
+                allowEmpty: true,
+            }),
+            identityMode,
+            files: requireArrayComponentField(component, 'files', ACPAgent.componentType).map((file) => ({
+                path: requireStringComponentField(file, 'path', ACPAgent.componentType),
+                content: requireStringComponentField(file, 'content', ACPAgent.componentType),
+                kind: requireStringComponentField(file, 'kind', ACPAgent.componentType),
+            })),
+            entrypoint: requireStringComponentField(component, 'entrypoint', ACPAgent.componentType),
+            eventTriggers: requireArrayComponentField(component, 'event_triggers', ACPAgent.componentType).map((trigger) => ({
+                key: requireStringComponentField(trigger, 'key', ACPAgent.componentType),
+                eventKey: requireStringComponentField(trigger, 'event_key', ACPAgent.componentType),
+                rqlFormula: requireStringComponentField(trigger, 'rql_formula', ACPAgent.componentType, {
+                    allowEmpty: true,
+                }),
+                promptTemplate: requireStringComponentField(trigger, 'prompt_template', ACPAgent.componentType),
+                enabled: requireBooleanComponentField(trigger, 'enabled', ACPAgent.componentType),
+            })),
+        };
+        return new ACPAgent(scope, props, requireStringComponentField(component, 'source_agent_id', ACPAgent.componentType));
+    }
+    getSourceAgentId() {
+        return this._sourceAgentId;
+    }
+    getApiName() {
+        return this._apiName;
+    }
+    setName(name) {
+        this._name = name;
+        return this;
+    }
+    setDescription(description) {
+        this._description = description;
+        return this;
+    }
+    setIdentity(identityMode) {
+        if (identityMode !== 'runner') {
+            throw new Error('ACP agents support only runner identity.');
+        }
+        return this;
+    }
+    setEventTriggers(eventTriggers) {
+        this._eventTriggers = [...eventTriggers];
+        return this;
+    }
+    setSource(files, entrypoint) {
+        this._files = [...files];
+        this._entrypoint = entrypoint;
+        return this;
+    }
+    toDict() {
+        const component = {
+            type: ACPAgent.componentType,
+            source_agent_id: this._sourceAgentId,
+            api_name: this._apiName,
+            name: this._name,
+            description: this._description,
+            identity_mode: 'runner',
+            files: this._files.map((file) => ({
+                type: ACPAgent.componentType,
+                path: file.path,
+                content: file.content,
+                kind: file.kind,
+            })),
+            entrypoint: this._entrypoint,
+            event_triggers: this._eventTriggers.map((trigger) => ({
+                type: ACPAgent.componentType,
+                key: trigger.key,
+                event_key: trigger.eventKey,
+                rql_formula: trigger.rqlFormula ?? '',
+                prompt_template: trigger.promptTemplate,
+                enabled: trigger.enabled ?? true,
+            })),
+        };
+        return component;
+    }
+}
+ACPAgent.componentType = 'ACP_AGENT';
+//# sourceMappingURL=acp-agent.mjs.map

package/lib/manifest/acp-agent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-agent.mjs","sourceRoot":"","sources":["../../src/lib/manifest/acp-agent.ts"],"names":[],"mappings":"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"}

package/lib/manifest/agent.d.mts

@@ -0,0 +1,60 @@
+import { type ExistingManifestContextOptions } from "./existing-manifest-context.mjs";
+import type { ManifestScope } from "./manifest-builder.mjs";
+import type { CustomSkill } from "./custom-skill.mjs";
+export type AgentIdentityMode = 'runner' | 'user';
+export interface AgentSourceFile {
+    path: string;
+    content: string;
+    kind: string;
+}
+/**
+ * Initialization properties for {@link Agent}.
+ */
+export interface AgentProps {
+    /** Stable system name for this agent. */
+    apiName: string;
+    /** Display name shown in Rippling. */
+    name: string;
+    /** Human-readable description of the agent. */
+    description?: string;
+    /** Identity used when the agent runs. Defaults to `runner`. */
+    identityMode?: AgentIdentityMode;
+    /** Role used when `identityMode` is `user`. */
+    identityRoleId?: string;
+    /** Source files for the agent's latest revision. */
+    files: AgentSourceFile[];
+    /** Path of the source file that starts the agent. */
+    entrypoint: string;
+    /** Existing Custom Skills included in the agent's latest revision. */
+    skills?: CustomSkill[];
+}
+/**
+ * Defines an agent and its latest source revision in a single manifest component.
+ *
+ * Reinstalling a component with the same `apiName` updates the agent metadata and
+ * creates a new source revision when its source or skills change.
+ */
+export declare class Agent {
+    static readonly componentType: "AGENT";
+    private readonly _apiName;
+    private _name;
+    private _description;
+    private _identityMode;
+    private _identityRoleId;
+    private _files;
+    private _entrypoint;
+    private _skills;
+    constructor(scope: ManifestScope, props: AgentProps);
+    /** Loads this agent from the active existing-manifest JSON context. */
+    static loadFromExisting(apiName: string, options?: ExistingManifestContextOptions): Agent;
+    /** @internal Hydrates an agent from existing manifest wire JSON. */
+    static _fromExistingComponent(scope: ManifestScope, component: Record<string, any>, resolveSkill: (sourceSkillId: string) => CustomSkill): Agent;
+    getApiName(): string;
+    setName(name: string): this;
+    setDescription(description: string): this;
+    setIdentity(identityMode: AgentIdentityMode, identityRoleId?: string): this;
+    setSource(files: AgentSourceFile[], entrypoint: string): this;
+    setSkills(skills: CustomSkill[]): this;
+    toDict(): Record<string, any>;
+}
+//# sourceMappingURL=agent.d.mts.map

package/lib/manifest/agent.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.mts","sourceRoot":"","sources":["../../src/lib/manifest/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,8BAA8B,EAAE,wCAAoC;AAC9G,OAAO,KAAK,EAAE,aAAa,EAAE,+BAA2B;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,2BAAuB;AAGlD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,KAAK;IAChB,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAG,OAAO,CAAU;IAEjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAA4B;gBAE/B,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU;IAYnD,uEAAuE;IACvE,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,8BAAmC,GAAG,KAAK;IAI7F,oEAAoE;IACpE,MAAM,CAAC,sBAAsB,CAC3B,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,YAAY,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,WAAW,GACnD,KAAK;IAkBR,UAAU,IAAI,MAAM;IAIpB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKzC,WAAW,CAAC,YAAY,EAAE,iBAAiB,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAM3E,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAM7D,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI;IAKtC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAgB9B"}

package/lib/manifest/agent.d.ts

@@ -0,0 +1,60 @@
+import { type ExistingManifestContextOptions } from "./existing-manifest-context.js";
+import type { ManifestScope } from "./manifest-builder.js";
+import type { CustomSkill } from "./custom-skill.js";
+export type AgentIdentityMode = 'runner' | 'user';
+export interface AgentSourceFile {
+    path: string;
+    content: string;
+    kind: string;
+}
+/**
+ * Initialization properties for {@link Agent}.
+ */
+export interface AgentProps {
+    /** Stable system name for this agent. */
+    apiName: string;
+    /** Display name shown in Rippling. */
+    name: string;
+    /** Human-readable description of the agent. */
+    description?: string;
+    /** Identity used when the agent runs. Defaults to `runner`. */
+    identityMode?: AgentIdentityMode;
+    /** Role used when `identityMode` is `user`. */
+    identityRoleId?: string;
+    /** Source files for the agent's latest revision. */
+    files: AgentSourceFile[];
+    /** Path of the source file that starts the agent. */
+    entrypoint: string;
+    /** Existing Custom Skills included in the agent's latest revision. */
+    skills?: CustomSkill[];
+}
+/**
+ * Defines an agent and its latest source revision in a single manifest component.
+ *
+ * Reinstalling a component with the same `apiName` updates the agent metadata and
+ * creates a new source revision when its source or skills change.
+ */
+export declare class Agent {
+    static readonly componentType: "AGENT";
+    private readonly _apiName;
+    private _name;
+    private _description;
+    private _identityMode;
+    private _identityRoleId;
+    private _files;
+    private _entrypoint;
+    private _skills;
+    constructor(scope: ManifestScope, props: AgentProps);
+    /** Loads this agent from the active existing-manifest JSON context. */
+    static loadFromExisting(apiName: string, options?: ExistingManifestContextOptions): Agent;
+    /** @internal Hydrates an agent from existing manifest wire JSON. */
+    static _fromExistingComponent(scope: ManifestScope, component: Record<string, any>, resolveSkill: (sourceSkillId: string) => CustomSkill): Agent;
+    getApiName(): string;
+    setName(name: string): this;
+    setDescription(description: string): this;
+    setIdentity(identityMode: AgentIdentityMode, identityRoleId?: string): this;
+    setSource(files: AgentSourceFile[], entrypoint: string): this;
+    setSkills(skills: CustomSkill[]): this;
+    toDict(): Record<string, any>;
+}
+//# sourceMappingURL=agent.d.ts.map

package/lib/manifest/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/lib/manifest/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,8BAA8B,EAAE,uCAAoC;AAC9G,OAAO,KAAK,EAAE,aAAa,EAAE,8BAA2B;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,0BAAuB;AAGlD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,KAAK;IAChB,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAG,OAAO,CAAU;IAEjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAA4B;gBAE/B,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU;IAYnD,uEAAuE;IACvE,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,8BAAmC,GAAG,KAAK;IAI7F,oEAAoE;IACpE,MAAM,CAAC,sBAAsB,CAC3B,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,YAAY,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,WAAW,GACnD,KAAK;IAkBR,UAAU,IAAI,MAAM;IAIpB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKzC,WAAW,CAAC,YAAY,EAAE,iBAAiB,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAM3E,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAM7D,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI;IAKtC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAgB9B"}

package/lib/manifest/agent.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Agent = void 0;
+const existing_manifest_context_1 = require("./existing-manifest-context.js");
+const _existing_component_fields_1 = require("./_existing-component-fields.js");
+/**
+ * Defines an agent and its latest source revision in a single manifest component.
+ *
+ * Reinstalling a component with the same `apiName` updates the agent metadata and
+ * creates a new source revision when its source or skills change.
+ */
+class Agent {
+    constructor(scope, props) {
+        this._apiName = props.apiName;
+        this._name = props.name;
+        this._description = props.description;
+        this._identityMode = props.identityMode;
+        this._identityRoleId = props.identityRoleId;
+        this._files = props.files;
+        this._entrypoint = props.entrypoint;
+        this._skills = props.skills == null ? undefined : [...props.skills];
+        scope._register(this);
+    }
+    /** Loads this agent from the active existing-manifest JSON context. */
+    static loadFromExisting(apiName, options = {}) {
+        return (0, existing_manifest_context_1.getExistingManifestContext)(options).loadAgent(apiName);
+    }
+    /** @internal Hydrates an agent from existing manifest wire JSON. */
+    static _fromExistingComponent(scope, component, resolveSkill) {
+        const props = {
+            apiName: (0, _existing_component_fields_1.requireStringComponentField)(component, 'api_name', Agent.componentType),
+            name: (0, _existing_component_fields_1.requireStringComponentField)(component, 'name', Agent.componentType),
+            files: component['files'] ?? [],
+            entrypoint: (0, _existing_component_fields_1.requireStringComponentField)(component, 'entrypoint', Agent.componentType),
+        };
+        if (component['description'] !== undefined)
+            props.description = component['description'];
+        if (component['identity_mode'] !== undefined)
+            props.identityMode = component['identity_mode'];
+        if (component['identity_role_id'] !== undefined)
+            props.identityRoleId = component['identity_role_id'];
+        if (component['skill_ids'] !== undefined) {
+            props.skills = (0, _existing_component_fields_1.requireArrayComponentField)(component, 'skill_ids', Agent.componentType).map(resolveSkill);
+        }
+        return new Agent(scope, props);
+    }
+    getApiName() {
+        return this._apiName;
+    }
+    setName(name) {
+        this._name = name;
+        return this;
+    }
+    setDescription(description) {
+        this._description = description;
+        return this;
+    }
+    setIdentity(identityMode, identityRoleId) {
+        this._identityMode = identityMode;
+        this._identityRoleId = identityRoleId;
+        return this;
+    }
+    setSource(files, entrypoint) {
+        this._files = files;
+        this._entrypoint = entrypoint;
+        return this;
+    }
+    setSkills(skills) {
+        this._skills = [...skills];
+        return this;
+    }
+    toDict() {
+        const component = {
+            type: Agent.componentType,
+            api_name: this._apiName,
+            name: this._name,
+            files: this._files,
+            entrypoint: this._entrypoint,
+        };
+        if (this._description !== undefined)
+            component['description'] = this._description;
+        if (this._identityMode !== undefined)
+            component['identity_mode'] = this._identityMode;
+        if (this._identityRoleId !== undefined)
+            component['identity_role_id'] = this._identityRoleId;
+        if (this._skills !== undefined) {
+            component['skill_ids'] = this._skills.map((skill) => skill.getSourceSkillId());
+        }
+        return component;
+    }
+}
+exports.Agent = Agent;
+Agent.componentType = 'AGENT';
+//# sourceMappingURL=agent.js.map

package/lib/manifest/agent.js.map

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

package/lib/manifest/agent.mjs

@@ -0,0 +1,90 @@
+import { getExistingManifestContext } from "./existing-manifest-context.mjs";
+import { requireArrayComponentField, requireStringComponentField } from "./_existing-component-fields.mjs";
+/**
+ * Defines an agent and its latest source revision in a single manifest component.
+ *
+ * Reinstalling a component with the same `apiName` updates the agent metadata and
+ * creates a new source revision when its source or skills change.
+ */
+export class Agent {
+    constructor(scope, props) {
+        this._apiName = props.apiName;
+        this._name = props.name;
+        this._description = props.description;
+        this._identityMode = props.identityMode;
+        this._identityRoleId = props.identityRoleId;
+        this._files = props.files;
+        this._entrypoint = props.entrypoint;
+        this._skills = props.skills == null ? undefined : [...props.skills];
+        scope._register(this);
+    }
+    /** Loads this agent from the active existing-manifest JSON context. */
+    static loadFromExisting(apiName, options = {}) {
+        return getExistingManifestContext(options).loadAgent(apiName);
+    }
+    /** @internal Hydrates an agent from existing manifest wire JSON. */
+    static _fromExistingComponent(scope, component, resolveSkill) {
+        const props = {
+            apiName: requireStringComponentField(component, 'api_name', Agent.componentType),
+            name: requireStringComponentField(component, 'name', Agent.componentType),
+            files: component['files'] ?? [],
+            entrypoint: requireStringComponentField(component, 'entrypoint', Agent.componentType),
+        };
+        if (component['description'] !== undefined)
+            props.description = component['description'];
+        if (component['identity_mode'] !== undefined)
+            props.identityMode = component['identity_mode'];
+        if (component['identity_role_id'] !== undefined)
+            props.identityRoleId = component['identity_role_id'];
+        if (component['skill_ids'] !== undefined) {
+            props.skills = requireArrayComponentField(component, 'skill_ids', Agent.componentType).map(resolveSkill);
+        }
+        return new Agent(scope, props);
+    }
+    getApiName() {
+        return this._apiName;
+    }
+    setName(name) {
+        this._name = name;
+        return this;
+    }
+    setDescription(description) {
+        this._description = description;
+        return this;
+    }
+    setIdentity(identityMode, identityRoleId) {
+        this._identityMode = identityMode;
+        this._identityRoleId = identityRoleId;
+        return this;
+    }
+    setSource(files, entrypoint) {
+        this._files = files;
+        this._entrypoint = entrypoint;
+        return this;
+    }
+    setSkills(skills) {
+        this._skills = [...skills];
+        return this;
+    }
+    toDict() {
+        const component = {
+            type: Agent.componentType,
+            api_name: this._apiName,
+            name: this._name,
+            files: this._files,
+            entrypoint: this._entrypoint,
+        };
+        if (this._description !== undefined)
+            component['description'] = this._description;
+        if (this._identityMode !== undefined)
+            component['identity_mode'] = this._identityMode;
+        if (this._identityRoleId !== undefined)
+            component['identity_role_id'] = this._identityRoleId;
+        if (this._skills !== undefined) {
+            component['skill_ids'] = this._skills.map((skill) => skill.getSourceSkillId());
+        }
+        return component;
+    }
+}
+Agent.componentType = 'AGENT';
+//# sourceMappingURL=agent.mjs.map

package/lib/manifest/agent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.mjs","sourceRoot":"","sources":["../../src/lib/manifest/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAuC,wCAAoC;AAG9G,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,yCAAqC;AAgCvG;;;;;GAKG;AACH,MAAM,OAAO,KAAK;IAYhB,YAAY,KAAoB,EAAE,KAAiB;QACjD,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,cAAc,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QACpE,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,uEAAuE;IACvE,MAAM,CAAC,gBAAgB,CAAC,OAAe,EAAE,UAA0C,EAAE;QACnF,OAAO,0BAA0B,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,oEAAoE;IACpE,MAAM,CAAC,sBAAsB,CAC3B,KAAoB,EACpB,SAA8B,EAC9B,YAAoD;QAEpD,MAAM,KAAK,GAAe;YACxB,OAAO,EAAE,2BAA2B,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC;YAChF,IAAI,EAAE,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC;YACzE,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE;YAC/B,UAAU,EAAE,2BAA2B,CAAC,SAAS,EAAE,YAAY,EAAE,KAAK,CAAC,aAAa,CAAC;SACtF,CAAC;QACF,IAAI,SAAS,CAAC,aAAa,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;QACzF,IAAI,SAAS,CAAC,eAAe,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,YAAY,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC;QAC9F,IAAI,SAAS,CAAC,kBAAkB,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,cAAc,GAAG,SAAS,CAAC,kBAAkB,CAAC,CAAC;QACtG,IAAI,SAAS,CAAC,WAAW,CAAC,KAAK,SAAS,EAAE,CAAC;YACzC,KAAK,CAAC,MAAM,GAAG,0BAA0B,CAAS,SAAS,EAAE,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAChG,YAAY,CACb,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc,CAAC,WAAmB;QAChC,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW,CAAC,YAA+B,EAAE,cAAuB;QAClE,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;QAClC,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,KAAwB,EAAE,UAAkB;QACpD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,MAAqB;QAC7B,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,MAAM,SAAS,GAAwB;YACrC,IAAI,EAAE,KAAK,CAAC,aAAa;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,KAAK;YAChB,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,UAAU,EAAE,IAAI,CAAC,WAAW;SAC7B,CAAC;QACF,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS;YAAE,SAAS,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC;QAClF,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;YAAE,SAAS,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC;QACtF,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS;YAAE,SAAS,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC;QAC7F,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;;AAjGe,mBAAa,GAAG,OAAgB,CAAC"}