Skip to content

forcedotcom/sf-skills / plugins/builder/service-itsm/skills/service-itsm-agentic-setup-employee-agent-configure

service-itsm-agentic-setup-employee-agent-configure

Unverified

Create and activate an IT Service Employee agent as a Next-Gen Authoring (NGA) native agent from an ITSM Employee agent template's Agent Script, via the Salesforce CLI (sf): read the template, check idempotency, create the NGA bundle then publish and activate, verify live. Defaults to the broad IT Service Employee template; when the user names a specialized Employee template (Password Manager Assistance, Certificate Management, Onboarding, Hardware Request, and ~47 others catalogued in references/specialized-templates.md — all under the `svc_emp_intelligence__` namespace), pins that one instead. Idempotent per developer name. TRIGGER when the user asks to create/set up/provision/activate the Employee agent, the IT Service Employee agent, or a specialized Employee agent (password manager, certificate, onboarding, hardware request, etc.). DO NOT TRIGGER: prerequisite checks (service-itsm-agentic-setup-agentforce-studio-validate), CMDB CRUD, Fulfiller setup (service-itsm-agentic-setup-fulfiller-agent-configure).

FileKindSize
SKILL.mdskill md29.4 KB
references/cli-invocation.mdmarkdown22.4 KB
references/error-taxonomy.mdmarkdown4.1 KB
references/reactivation.mdmarkdown4.2 KB
references/report-format.mdmarkdown4.9 KB
references/specialized-templates.mdmarkdown10.5 KB
references/workflow-detail.mdmarkdown18.2 KB
scripts/build-create-body.mjsexecutablescript4.7 KB
scripts/classify-agent-existence.mjsexecutablescript13.5 KB
scripts/classify-preflight.mjsexecutablescript11.4 KB
scripts/create-scratch-dir.mjsexecutablescript2.3 KB
scripts/render-report.mjsexecutablescript12.2 KB

scripts/build-create-body.mjs

View on GitHub
#!/usr/bin/env node
// Build the NGA createBundleWithVersion request body from the shipped
// Employee template's agentScript.
//
// The legacy `agent-templates` read already returns the template's full Agent
// Script (AFScript) content in its `agentScript` field, HTML-entity-encoded
// (sometimes double-encoded). This script:
//   1. Locates the matching template item by masterLabel in the
//      agent-templates response.
//   2. Fully HTML-decodes `agentScript` (named + numeric entities, multi-pass
//      to unwind double-encoding).
//   3. Substitutes the script's internal `config.developer_name` /
//      `config.agent_label` with the collected <developerName> / <label> —
//      the bundle's outer apiName must match the script's internal
//      developer_name or the two diverge (the platform will otherwise
//      auto-suffix the apiName).
//   4. Writes the createBundleWithVersion body
//      { apiName, label, assets: [{ resourceName: "agentDefinition",
//        resourceType: "agentDefinition", sections: [], resourceContent }] }
//      to <outPath>.
//
// Usage:
//   node build-create-body.mjs <agent-templates.json> <masterLabel> <developerName> <label> <outPath>
//
// Exits 2 on missing/bad args, 3 if the template or its agentScript can't be found.

import { readFileSync, writeFileSync } from 'node:fs';

const [templatesPath, masterLabel, developerName, label, outPath] = process.argv.slice(2);
if (!templatesPath || !masterLabel || !developerName || !label || !outPath) {
  process.stderr.write('usage: node build-create-body.mjs <agent-templates.json> <masterLabel> <developerName> <label> <outPath>\n');
  process.exit(2);
}

function decodeHtmlEntities(text) {
  let prev = text;
  for (let pass = 0; pass < 4; pass += 1) {
    const next = prev
      .replace(/&amp;/g, '&')
      .replace(/&quot;/g, '"')
      .replace(/&#39;/g, "'")
      .replace(/&lt;/g, '<')
      .replace(/&gt;/g, '>')
      .replace(/&#(\d+);/g, (_, code) => String.fromCharCode(parseInt(code, 10)));
    if (next === prev) break;
    prev = next;
  }
  return prev;
}

let templatesData;
try {
  templatesData = JSON.parse(readFileSync(templatesPath, 'utf8'));
} catch {
  process.stderr.write(`error: could not read/parse ${templatesPath}\n`);
  process.exit(3);
}

const items = Array.isArray(templatesData?.data) ? templatesData.data : [];
// Filter to `svc_emp_intelligence__` first — matches the preflight classifier.
// The agent-templates response also carries other-namespace entries; some
// share a masterLabel with an in-namespace entry (e.g. `System Password Reset
// Assistance`) so a `masterLabel`-only match would silently pick whichever
// appeared first in `data[]`.
const inNamespace = items.filter((it) => typeof it?.id === 'string' && it.id.startsWith('svc_emp_intelligence__'));
const wanted = String(masterLabel).trim().toLowerCase();
const match = inNamespace.find((it) => String(it?.masterLabel ?? '').trim().toLowerCase() === wanted);
if (!match) {
  process.stderr.write(`error: no svc_emp_intelligence__ template with masterLabel "${masterLabel}" found in ${templatesPath}\n`);
  process.exit(3);
}
if (!match.agentScript || typeof match.agentScript !== 'string' || !match.agentScript.trim()) {
  process.stderr.write(`error: template "${masterLabel}" (id=${match.id}) has no agentScript content\n`);
  process.exit(3);
}

// Escapes a value for use as a YAML double-quoted scalar — the agentScript's
// developer_name/agent_label fields are plain `"..."` strings, so a raw
// double-quote or backslash in a user-supplied label would otherwise break
// out of the scalar (e.g. label `Sam "Ops"` -> `agent_label: "Sam "Ops""`).
function yamlDoubleQuoteEscape(text) {
  return String(text).replace(/\\/g, '\\\\').replace(/"/g, '\\"');
}

const decoded = decodeHtmlEntities(match.agentScript);
const developerNameEscaped = yamlDoubleQuoteEscape(developerName);
const labelEscaped = yamlDoubleQuoteEscape(label);

const substituted = decoded
  .replace(/developer_name:\s*"[^"]*"/, () => `developer_name: "${developerNameEscaped}"`)
  .replace(/agent_label:\s*"[^"]*"/, () => `agent_label: "${labelEscaped}"`);

if (!substituted.includes(`developer_name: "${developerNameEscaped}"`)) {
  process.stderr.write('error: failed to substitute config.developer_name in the decoded agentScript\n');
  process.exit(3);
}
if (!substituted.includes(`agent_label: "${labelEscaped}"`)) {
  process.stderr.write('error: failed to substitute config.agent_label in the decoded agentScript\n');
  process.exit(3);
}

const body = {
  apiName: developerName,
  label,
  assets: [
    {
      resourceName: 'agentDefinition',
      resourceType: 'agentDefinition',
      sections: [],
      resourceContent: substituted,
    },
  ],
};

writeFileSync(outPath, JSON.stringify(body), 'utf8');
process.stdout.write(outPath + '\n');
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall