Skip to content

matthewwong525/WongStack / .agents/plugins/access

access

Verified

See who can sign in and what each person may use; add, change or remove a person.

FileKindSize
README.mdmarkdown3.4 KB
SKILL.mdskill md2.3 KB
VERSIONother6 B
hooks/claude.jsonconfig251 B
hooks/codex.jsonconfig232 B
references/setup.mdmarkdown9.7 KB
screen/access.cssother10.5 KB
screen/address.mjsscript2.1 KB
screen/api.mjsscript11.6 KB
screen/api.test.mjsscript13.4 KB
screen/app.mjsscript1.2 KB
screen/app.test.mjsscript40.3 KB
screen/confirm.mjsscript1.1 KB
screen/context.mjsscript248 B
screen/copy-text.mjsscript1.3 KB
screen/fields.mjsscript1001 B
screen/hidden.test.mjsscript6.8 KB
screen/labels.mjsscript1.4 KB
screen/leaving.test.mjsscript14.6 KB
screen/level-choice.mjsscript1.3 KB
screen/levels.mjsscript3.7 KB
screen/levels.test.mjsscript7.9 KB
screen/loading.mjsscript457 B
screen/main.d.mtsother1.0 KB
screen/main.mjsscript1.3 KB
screen/note.mjsscript2.1 KB
screen/note.test.mjsscript4.1 KB
screen/notices.mjsscript4.3 KB
screen/notices.test.mjsscript2.2 KB
screen/own.mjsscript889 B
screen/owner.mjsscript2.7 KB
screen/page.mjsscript4.2 KB
screen/people.mjsscript4.5 KB
screen/person-page.mjsscript3.5 KB
screen/person-page.test.mjsscript37.2 KB
screen/project-step.mjsscript1.7 KB
screen/project-step.test.mjsscript5.4 KB
screen/pushers.mjsscript3.5 KB
screen/pushers.test.mjsscript5.2 KB
screen/role-page.mjsscript2.5 KB
screen/role-select.mjsscript1.6 KB
screen/roles.mjsscript1.5 KB
screen/roles.test.mjsscript22.2 KB
screen/router.mjsscript3.3 KB
screen/seal.d.mtsother470 B
screen/seal.mjsscript2.6 KB
screen/seal.test.mjsscript1.1 KB
screen/services.mjsscript4.3 KB
screen/services.test.mjsscript12.5 KB
screen/set-fields.mjsscript3.5 KB
screen/status.mjsscript2.4 KB
screen/status.test.mjsscript2.7 KB
screen/style.test.mjsscript11.5 KB
screen/subjects.mjsscript487 B
screen/subjects.test.mjsscript2.4 KB
screen/table.mjsscript4.5 KB
screen/test-dom.mjsscript9.4 KB
screen/ui.mjsscript14.2 KB
screen/view.mjsscript2.1 KB
screen/welcome.mjsscript2.3 KB
screen/welcome.test.mjsscript11.2 KB
scripts/check-definitions.mjsexecutablescript1.1 KB
scripts/lib/check-definitions.mjsscript1.2 KB
scripts/lib/client.mjsscript4.6 KB
scripts/lib/openapi.mjsscript20.6 KB
scripts/lib/scrub.mjsscript7.0 KB
scripts/lib/seal-keys.mjsscript1.1 KB
scripts/lib/services.mjsscript17.6 KB
scripts/services.mjsexecutablescript8.6 KB
scripts/session-start.mjsscript1.7 KB
server/errors.d.mtsother572 B
server/errors.mjsscript1.8 KB
server/errors.test.mjsscript1.3 KB
server/forward.d.mtsother1.6 KB
server/forward.mjsscript11.0 KB
server/forward.test.mjsscript9.4 KB
server/index.d.mtsother3.3 KB
server/index.mjsscript11.3 KB
server/index.test.mjsscript11.8 KB
server/key-rules.d.mtsother643 B
server/key-rules.mjsscript4.0 KB
server/key-rules.test.mjsscript5.2 KB
server/levels.d.mtsother2.3 KB
server/levels.mjsscript4.3 KB
server/levels.test.mjsscript2.4 KB
server/management.mjsscript2.8 KB
server/page.mjsscript1.3 KB
server/pass.d.mtsother213 B
server/pass.mjsscript3.5 KB
server/people.mjsscript5.3 KB
server/policy.d.mtsother1.5 KB
server/policy.mjsscript8.1 KB
server/roles.mjsscript2.4 KB
server/sealed.d.mtsother377 B
server/sealed.mjsscript3.2 KB
server/sealed.test.mjsscript4.9 KB
server/services.d.mtsother487 B
server/services.mjsscript3.1 KB
server/services.test.mjsscript4.5 KB
server/sets.mjsscript4.5 KB
server/start.mjsscript1.8 KB
server/tools.d.mtsother1.2 KB
server/tools.mjsscript8.7 KB
server/tools.test.mjsscript10.4 KB
signin/cloudflare-list.d.mtsother969 B
signin/cloudflare-list.mjsscript11.6 KB
signin/cloudflare-list.test.mjsscript1.4 KB
signin/cloudflare.d.mtsother1.5 KB
signin/cloudflare.mjsscript7.2 KB
signin/cloudflare.test.mjsscript1.4 KB
signin/computer.d.mtsother557 B
signin/computer.mjsscript2.4 KB
signin/computer.test.mjsscript1.0 KB
store/contract.d.mtsother293 B
store/contract.mjsscript14.3 KB
store/interface.d.mtsother4.2 KB
store/interface.mjsscript1.2 KB
store/stand-in.d.mtsother93 B
store/stand-in.mjsscript10.4 KB
store/stand-in.test.mjsscript202 B

scripts/services.mjs

View on GitHub
#!/usr/bin/env node
// The services helper, through the app as this computer's person: skills/services/SKILL.md. A project with its own
// helper runs these through `runServices` with its own client (WongStack: scripts/company-api.mjs).
import { readFileSync, realpathSync } from 'node:fs';
import { dirname, resolve } from 'node:path';
import { fileURLToPath, pathToFileURL } from 'node:url';
import { parseArgs } from 'node:util';
import { accessClient } from './lib/client.mjs';
import { sealedBody } from './lib/seal-keys.mjs';
import { SLOTS, apiCommand, callCount, layout, missingPlace, notesPage, record, refresh } from './lib/services.mjs';

/** The repo this folder is installed in: .agents/skills/access/scripts is four folders down. */
export const REPO = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..', '..', '..');
const COMMANDS = ['services', 'api', 'record', 'key', 'tool'];
/** What a project with no place named for its services' records is told to fill. */
export const KEYS_UNSET = `The keys are not set up yet: give the app's Access slots \`keys\` and \`secret\`, and add "definitions" to ${SLOTS}. See .claude/skills/access/references/setup.md#8-keys-for-services.`;
export const usage = helper => `usage: ${helper} <command>
  services [--all] [--json]          the services you can use, and how ready each is
  api <key> [<call>]                 a service's calls, or how we use one; api company: the app's own
  record <key> <name> --file -       save a look-up through <key>.read as an example, and add its call
  record <key> <name> --last         save the last change made, never sending it again
  record --refresh [<key>]           ask each saved look-up again; the check names what no longer fits
  tool add <id> --file <JSON or ->   add a tool to the live app, owner or Admin: wiki/stack/connect-your-tools.md
  tool remove <id>
  key send <NAME> --value-stdin      seal a key read from stdin with the app's public key, here, and send it to the
                                     live app, owner or Admin; it goes live at the next publish
  key send <NAME> --sealed-file <file or ->   send a key sealed already, as {"sealed":{...},"ends":"abcd"}`;

/** Each service gains its notes page, and one used directly the number of calls its definition holds. */
export function withNotes(answer, root = REPO) {
  return { ...answer, services: answer.services.map(service => {
    const notes = notesPage(root, service.id);
    return { ...service, ...(notes && { notes }), ...(service.direct && /^[a-z][a-z0-9-]*$/.test(service.id) && layout(root).definitions && { calls: callCount(root, service.id) }) };
  }) };
}
const LEVELS = { read: 'Read', write: 'Read & write' };
function serviceState(service) {
  if (!service.level) return 'needs access: ask the owner';
  return service.ready ? `ready  ${LEVELS[service.level] ?? service.level}` : 'not saved yet: ask the owner';
}
const notesLine = ({ notes, docs }) => `  notes: ${notes.exists ? notes.path : `none yet; start ${notes.path}`}${docs ? `  guide: ${docs}` : ''}`;
/** The services list as a chat reads it: one line per service, its notes page, and the keys left out. */
export function serviceLines({ services, needAccess = 0 }, helper = layout(REPO).helper) {
  const width = key => Math.max(0, ...services.map(service => String(service[key] ?? '').length));
  const lines = services.flatMap(service => [
    [service.name.padEnd(width('name')), String(service.purpose ?? '').padEnd(width('purpose')), serviceState(service)].join('  '),
    ...(service.notes ? [notesLine(service)] : []), ...(service.calls === undefined ? [] : [`  calls: ${service.calls} · ${helper} api ${service.id}`])]);
  if (needAccess && !services.some(service => !service.level)) lines.push(`${needAccess} more key${needAccess === 1 ? ' needs' : 's need'} access: ask the owner`);
  return lines.length ? lines : ['No services yet.'];
}

/** Adds or removes a tool kept in the app's data, with no publish. The app checks the entry and who asks. */
async function toolCommand(client, action, [id, ...rest], input, wrong) {
  if (!['add', 'remove'].includes(action) || !/^[a-z][a-z0-9-]*$/.test(id ?? '') || rest.length) throw wrong();
  const origin = client.target();
  const init = action === 'add' ? { method: 'PUT', headers: { Origin: origin, 'Content-Type': 'application/json' }, body: JSON.stringify(input()) }
    : { method: 'DELETE', headers: { Origin: origin } };
  const { value } = await client.http(`/api/access/tools/${id}`, init, origin, undefined, { check: ' Check with `services --all` before repeating.' });
  return value;
}

/** Sends one key to the live app, sealed here with the app's public key, or sealed already. The app checks the name
 *  and who asks. */
async function keyCommand(client, action, [name, ...rest], values, wrong) {
  if (action !== 'send' || !/^[A-Z][A-Z0-9_]*$/.test(name ?? '') || rest.length || Boolean(values['value-stdin']) === (values['sealed-file'] !== undefined)) throw wrong();
  const { body, refused } = await sealedBody(client, name, { valueStdin: values['value-stdin'], sealedFile: values['sealed-file'] });
  if (refused) return refused;
  const origin = client.target();
  const { value } = await client.http(`/api/access/keys/${name}`, { method: 'PUT', headers: { Origin: origin, 'Content-Type': 'application/json' }, body: JSON.stringify(body) },
    origin, undefined, { check: ' Check with `services --all` before repeating.' });
  return value;
}

/** A refusal is printed whole, and ends as a failure a script can see. */
function printed(value) {
  console.log(JSON.stringify(value, null, 2));
  if (value?.error && typeof value.error === 'object') process.exitCode = 1;
}

/** One command, parsed already: `command`, `args` (the words after it) and `values` (its options). `input()` reads
 *  `--file`. Prints the answer; a failure sets the exit code. */
export async function runServices({ command, args = [], values = {} }, { client, root = REPO, input } = {}) {
  const where = layout(root);
  const wrong = () => new Error(usage(where.helper));
  const [id, ...extra] = args;
  input ??= () => { try { return JSON.parse(readFileSync(values.file === '-' ? 0 : values.file, 'utf8')); } catch { throw new Error('Invalid JSON input; use a JSON file or stdin'); } };
  if (!COMMANDS.includes(command)) throw wrong();
  if (command === 'services') {
    if (args.length) throw wrong();
    // No place named for the keys' records: the keys are not set up, so nothing asks an app that may not be there.
    if (missingPlace(root)) { console.log(KEYS_UNSET); return; }
    const { value } = await client.http(`/api/services${values.all ? '?all=1' : ''}`);
    if (value.error) throw new Error(value.error.message || 'The app could not list its services; it may need an update.');
    if (!Array.isArray(value.services)) throw new Error('Invalid services list');
    const answer = withNotes(value, root);
    console.log(values.json ? JSON.stringify(answer, null, 2) : serviceLines(answer, where.helper).join('\n'));
  } else if (command === 'api') {
    if (extra.length > 1) throw wrong();
    if (id !== 'company' && missingPlace(root)) throw new Error(missingPlace(root));
    console.log(await apiCommand(client, root, id, extra[0]));
  } else if (command === 'record') {
    if (missingPlace(root)) throw new Error(missingPlace(root));
    if (values.refresh) {
      if (extra.length) throw wrong();
      const { text, ok } = await refresh(client, root, id);
      console.log(text);
      if (!ok) process.exitCode = 1;
      return;
    }
    if (extra.length !== 1 || Boolean(values.last) === (values.file !== undefined)) throw wrong();
    console.log(await record(client, root, id, extra[0], { input: values.last ? undefined : input(), last: values.last }));
  } else if (command === 'tool') printed(await toolCommand(client, id, extra, input, wrong));
  else printed(await keyCommand(client, id, extra, values, wrong));
}

const main = () => { try { return import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href; } catch { return false; } };
if (main()) {
  const helper = layout(REPO).helper;
  let parsed;
  try {
    parsed = parseArgs({ allowPositionals: true, options: { file: { type: 'string' }, 'sealed-file': { type: 'string' },
      ...Object.fromEntries(['all', 'json', 'last', 'refresh', 'value-stdin', 'help'].map(name => [name, { type: 'boolean' }])) } });
  } catch (error) { console.error(`${error.message}\n\n${usage(helper)}`); process.exit(2); }
  const { positionals: [command, ...args], values } = parsed;
  if (values.help || !command) console.log(usage(helper));
  else {
    try { await runServices({ command, args, values }, { client: accessClient({ root: REPO }) }); }
    catch (error) { console.error(error.message); process.exitCode = 1; }
  }
}
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall