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

server/tools.mjs

View on GitHub
// Tools added from a chat, live only, held to the key rules when saved and read. PUT and DELETE <prefix>tools/<id>:
// the owner or an Admin adds or removes one, with no publish. wiki/stack/connect-your-tools.md
import { AccessError } from './errors.mjs';
import { forwardProblem, undescribed } from './key-rules.mjs';

/** A tool's id: the same shape as a key used directly, short enough for a secret name. */
export const TOOL_ID = /^[a-z][a-z0-9-]{0,39}$/;
/** The one secret a tool sends, derived from its id and never stored free-form. */
export const toolSecret = id => `TOOL_${id.toUpperCase().replaceAll('-', '_')}`;

const isObject = value => typeof value === 'object' && value !== null && !Array.isArray(value);
const text = (value, max) => typeof value === 'string' && value.length <= max;
/** The first field an object holds beyond the ones named, as a dotted path. */
const unknownField = (value, fields, at) => { const extra = Object.keys(value).find(name => !fields.includes(name)); return extra === undefined ? null : `${at}${extra}: is not a field`; };

/** What a chat saves, checked field by field, strict: name, purpose, API guide, how to reach it and what only reads.
 *  Read is the one level unless the person asked for a key that changes things. A `forward.mcp` is an unknown field. */
export function toolInput(value) {
  const fail = problem => ({ problem });
  if (!isObject(value)) return fail('tool: must be an object');
  const extra = unknownField(value, ['title', 'purpose', 'docs', 'forward', 'levels'], '');
  if (extra) return fail(extra);
  const title = typeof value.title === 'string' ? value.title.trim() : null;
  if (title === null || title.length < 1 || title.length > 60) return fail('title: must be 1 to 60 characters');
  if (typeof value.purpose !== 'string') return fail('purpose: must be text');
  if (!text(value.docs, 500)) return fail('docs: must be text of at most 500 characters');
  const { forward } = value;
  if (!isObject(forward)) return fail('forward: must be an object');
  const extraForward = unknownField(forward, ['base', 'secret', 'header', 'prefix', 'headers', 'lookups', 'exchange'], 'forward.');
  if (extraForward) return fail(extraForward);
  if (!text(forward.base, 500)) return fail('forward.base: must be text of at most 500 characters');
  for (const name of ['secret', 'prefix']) if (forward[name] !== undefined && !text(forward[name], 100)) return fail(`forward.${name}: must be text of at most 100 characters`);
  if (!text(forward.header, 100)) return fail('forward.header: must be text of at most 100 characters');
  if (forward.headers !== undefined && (!isObject(forward.headers) ||
    Object.entries(forward.headers).some(([name, given]) => !/^[A-Za-z0-9-]{1,100}$/.test(name) || !text(given, 500)))) return fail('forward.headers: must name headers with text values');
  if (forward.lookups !== undefined && (!Array.isArray(forward.lookups) || forward.lookups.length > 50 ||
    forward.lookups.some(entry => !text(entry, 300)))) return fail('forward.lookups: must be at most 50 entries of text');
  if (forward.exchange !== undefined) {
    if (!isObject(forward.exchange)) return fail('forward.exchange: must be an object');
    const extraExchange = unknownField(forward.exchange, ['url'], 'forward.exchange.');
    if (extraExchange) return fail(extraExchange);
    if (!text(forward.exchange.url, 500)) return fail('forward.exchange.url: must be text of at most 500 characters');
  }
  const levels = value.levels ?? ['read'];
  const fits = Array.isArray(levels) && levels[0] === 'read' && (levels.length === 1 || (levels.length === 2 && levels[1] === 'write'));
  if (!fits) return fail('levels: must be ["read"] or ["read", "write"]');
  return { tool: { title, purpose: value.purpose, docs: value.docs, forward, levels } };
}

/** A tool as the registry holds it: its own secret, and its ID's when it trades them for a token; live only, marked
 *  as added in a chat. */
const entry = (id, tool) => ({ title: tool.title, purpose: tool.purpose, docs: tool.docs,
  secrets: [toolSecret(id), ...(tool.forward.exchange ? [`${toolSecret(id)}_ID`] : [])], levels: tool.levels, liveOnly: true, chat: true,
  forward: { ...tool.forward, secret: tool.forward.secret ?? toolSecret(id) } });

/** The tool as stored, or the first rule it breaks, named: the same rules the checks hold a project's key to. */
export function checkedTool(id, tool) {
  if (!TOOL_ID.test(id)) return { problem: "a tool's id is lowercase letters, digits and hyphens, at most 40" };
  // TOOL_<ID>_ID is the ID of a tool that trades it for a token, so no tool's own key may take that name.
  if (id.endsWith('-id')) return { problem: "a tool's id never ends in -id" };
  const made = entry(id, tool);
  if (made.forward.secret !== toolSecret(id)) return { problem: `secret must be the tool's own, ${toolSecret(id)}` };
  const problem = undescribed({ [id]: { ...made, docs: made.docs || undefined } })[0] ?? forwardProblem(id, made, made.forward);
  return problem ? { problem: problem.replace(new RegExp(`^${id}: `), '') } : { entry: made };
}

/** The stored rows as registry entries, read back through the same rules: a row that breaks one is left out. A row
 *  with an MCP server, no longer passed on, is skipped, named in `skipped`, and `audit(id)` is called for it. */
export async function storedTools(rows, { audit } = {}) {
  const entries = {};
  const skipped = [];
  for (const row of rows) {
    let forward;
    let levels;
    try { forward = JSON.parse(row.forward_json); levels = JSON.parse(row.levels_json); } catch { continue; }
    if (isObject(forward) && Object.hasOwn(forward, 'mcp')) { skipped.push(row.id); continue; }
    const read = toolInput({ title: row.title, purpose: row.purpose, docs: row.docs, forward, levels });
    const checked = read.tool ? checkedTool(row.id, read.tool) : null;
    if (checked?.entry) entries[row.id] = checked.entry;
  }
  for (const id of skipped) await audit?.(id);
  return { entries, skipped };
}

/** The store's tools as registry entries; none when the store can not be read. The first read that skips an MCP
 *  tool writes one change-record line naming it, `tool_skipped_mcp:<id>`, and no later read writes it again. */
export async function readTools(store, actor = 'access') {
  let rows;
  try { rows = await store.tools(); } catch { return {}; }
  const { entries } = await storedTools(rows, { audit: async id => {
    const event = `tool_skipped_mcp:${id}`;
    try { if (!await store.audited(event)) await store.audit(actor, event); } catch { /* the list still loads */ }
  } });
  return entries;
}

/** What a level on a tool lets a person do: its address, its look-ups and the levels it offers. */
const reads = (forward, levels) => JSON.stringify([forward.base, forward.lookups ?? [], levels]);

/** PUT or DELETE <prefix>tools/<id>, for a caller the module has already found to manage Access. */
export async function toolsRoute(ctx) {
  const { request, pass, store, slots, reply, refuse } = ctx;
  try {
    const id = ctx.path.slice('tools/'.length);
    if (!TOOL_ID.test(id) || !['PUT', 'DELETE'].includes(request.method)) return refuse('not_found', 404);
    // A preview runs branch code, so it holds no tool; a project key's name stays the project's.
    if (!pass.live) return refuse('live_only', 409);
    // The keys slot may carry the saved tools too, as WongStack's does: only a key the code lists is the project's.
    const own = slots.keys?.() ?? {};
    if (Object.hasOwn(own, id) && !own[id].chat) return refuse('code_key', 409);
    // As Access's first read does, so a fresh install's first look-up right after a save is not refused.
    await ctx.start();
    const before = (await store.tools()).find(row => row.id === id);
    if (request.method === 'DELETE') {
      if (!before) return refuse('not_found', 404);
      await store.removeTool(id, pass.actor);
      return reply({ removed: true });
    }
    const read = toolInput(await ctx.json(16_384));
    if (read.problem) return refuse('bad_tool', 400, read.problem);
    const checked = checkedTool(id, read.tool);
    if (checked.problem) return refuse('bad_tool', 400, checked.problem);
    const { title, purpose, docs, forward, levels } = checked.entry;
    // A level given for what the tool read before does not carry over to what it reads now.
    let changed = false;
    if (before) {
      try { changed = reads(JSON.parse(before.forward_json), JSON.parse(before.levels_json)) !== reads(forward, levels); } catch { changed = true; }
    }
    await store.saveTool({ row: { id, title, purpose, docs, forward_json: JSON.stringify(forward), levels_json: JSON.stringify(levels) },
      actor: pass.actor, clearLevels: changed });
    return reply({ id, secret: toolSecret(id) });
  } catch (error) {
    return error instanceof AccessError ? refuse(error.code, error.status) : refuse('access_unavailable', 503);
  }
}
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